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Nomenclature 



Symbol: 
A, B, C 
a 

b 

C 

D 

£)], £>2 

d 

E 

e 

F 

f 

F, G, H 

F v , G v , H v , 


Definition: 
flux Jacobians 

speed of sound 

part of viscous term in energy equation; also, compression parameter in 
minmod flux limiter 

constant 

modeling variable in turbulence model equations 
diffusion term in turbulence model equations 
damping terms in Baldwin-Barth turbulence model 

distance to nearest wall; also, directed distance to the wall 
total energy 

total energy per unit volume 
function 

damping function; also, frequency 
inviscid fluxes 
viscous fluxes 


G \ 

H 

I 

I 

i, j, k 
J 

K 


modeling variable (similar to -C^ term) in turbulence model equations 

total enthalpy 

restriction operator 

identity matrix 

grid indices 

transformation Jacobian, J = d(^, T|, Q/3(x, y, z ) 
reduced frequency 

growth rate 
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Nomenclature 

Symbol: 

k 

Definition: 

kinetic energy in turbulence model equations 

L 

characteristic length 

L ref 

length in grid corresponding to L 

Lr 

reference length used by code Lr = L/ L re j 

l 

reference length; also, length scale in Baldwin-Lomax turbulence model 

M 

Mach number, M = | V | /a 

M 

transformation matrix from conserved variables to primitive variables, 
9Q/3q 

m 

sub-iteration counter 

N 

spatially-factored implicit matrix term 

n 

direction normal to the wall 

n 

current iteration 

p 

production term in turbulence model equations 

Pr 

Prandtl number 

P 

static pressure 

Q 

conserved variables 

q 

primitive variables 

q 

heat flux terms 

R 

residual vector 

R 

turbulent Reynolds number term in Baldwin-Barth turbulence model; also, 
residual term 

Re l 

Reynolds number, /?e- = p^lvl^Z/jl^ 

S 

mean rate-of-strain tensor 

Sp 

production source term in turbulence model equations 

S D 

destruction source term in turbulence model equations 

s 

entropy; also, parameter used in smooth flux limiter 

T 

matrix of eigenvectors 

t 

time; also, parameter used in smooth flux limiter 

U, V, w 

contravariant velocities 
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Nomenclature 


Symbol: 

u, v, w 

+ 

u 

v 

V 

|V| 

w 

X 

x, y,z 

+ 

y 

a 

p 

V 

A 

5 

E 

K 

A 

X 

p 

v 

V 

P 

T 

<t> 

£2 


Definition: 

Cartesian velocities in x, y, z directions 
law-of-the-wall variable, n + = M Aj /p/x w 

corrections on coarser meshes, used to update finer mesh in the multigrid 
algorithm 

velocity vector, (m, v, w) 

total velocity 

mean vorticity tensor 

represents either k, to , or e in general turbulence model equations 
Cartesian coordinates 

law-of-the-wall variable, y + = ^px w y/jl 

angle of attack; also, used as constant in turbulence model equations 

side-slip angle; also, used as constant in turbulence model equations 

ratio of specific heats, y = 1.4; also, variable in turbulence model equa- 
tions 

incremental quantity; also, forward difference operator 
difference operator 

dissipation term in turbulence model equations; also, small constant used 
in flux limiters 

spatial differencing parameter; also, von Karman constant used in turbu- 
lence model equations 

matrix of eigenvalues 
bulk viscosity coefficient 
molecular viscosity coefficient 
kinematic viscosity 

field equation variable in Spalart-Allmaras turbulence model 

general curvilinear coordinates; also, rj and £ used as variables in EASM 
turbulence model equations 

density 

shear stress tensor; also, relative truncation error 

parameter governing the temporal order of accuracy of the scheme 

magnitude of vorticity 
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Nomenclature 


Symbol: 

Definition: 

CO 

rotational velocity; also, variable in turbulence model equations, 
co = e/k 

V 

gradient operator VX = dX/dx t 

Subscripts 

Symbol: 

Definition: 

e 

denotes estimated value 

i, j, k 

denote grid indices; also, summation convention where specified 

inv 

denotes inviscid part 

k 

denotes k turbulence model quantity 

L 

denotes left-hand state; also, denotes laminar quantity where specified 

l 

denotes summation convention 

R 

denotes right-hand state 

T 

denotes turbulent quantity 

t 

denotes total quantity; e.g. p t => total pressure ; also, denotes differentia- 
tion with respect to time 

V 

denotes viscous term 

w 

denotes wall condition 

X, y, z 

denote differentiation with respect to x, y, z ; x also denotes tensor nota- 
tion where specified 

8 

denotes £ turbulence model quantity 

CO 

denotes co turbulence model quantity 

oo 

denotes reference conditions, typically free-stream conditions 

+, — 

denotes forward or backward difference operator 


denotes reference to a particular coordinate direction 

Superscripts 

Symbol: 

Definition: 

b 

denotes biased gradient 

c 

denotes correction term 


X 
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Superscripts 

Symbol: 

Definition: 

r 

denotes residual smoothing term 

A 

denotes quantities in generalized coordinates 

- 

denotes dimensional value; also, denotes Roe-averaged variable where 
specified 

/ 

denotes partial derivative with respect to q and intermediate values in the 
time advancement scheme 

-> 

denotes a vector quantity 

+ > “ 

denotes forward or backward difference operator 

Abbreviations 

CFD 

Computational Fluid Dynamics 

CFL 

Courant number 

CFL3D 

Computational Fluids Laboratory 3-Dimensional (flow solver) 

CPU 

Central Processing Unit 

EASM 

Explicit Algebraic Stress Model 

FAST 

Flow Analysis Software Toolkit 44 

LRR 

Launder-Reese-Rodi 

GRIDGEN 

GRID GENeration 36 

MaGGiE 

MultiGeometry Grid Embedder 1 1 

NACA 

National Advisory Committee for Aeronautics 

PLOT3D 

PLOT 3 -Dimensional 43 

RAE 

Royal Aircraft Establishment 

SSG 

Speziale-Sarkar-Gatski 

SST 

Shear Stress Transport 

TLNS3D 

Thin-Layer Navier-Stokes 3-Dimensional (flow solver) 42 
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CHAPTER 1 


Introduction 



Welcome to CFL3D (Version 5.0), a Reynolds-Averaged thin-layer Navier-Stokes flow 
solver for structured grids. The original version of CFL3D was developed in the early 
1980’s in the Computational Fluids Laboratory at NASA Langley Research Center; hence 
the name of the code, which is an acronym for the Computational Fluids Laboratory 3- 
Dimensional flow solver. As the number of people who have utilized CFL3D has 
increased over time, so have the demands on the code. Consequently, it is constantly 
“under construction” with numerous researchers having contributed to code upgrades. 
Currently, the primary developers/supporters of CFL3D are Dr. Christopher L. Rumsey 
and Dr. Robert T. Biedron of the Aerodynamics and Acoustics Branch at NASA Langley. 
An overview of the history of the code can be found in Rumsey, Biedron, and Thomas. 32 

CFL3D solves the time-dependent conservation law form of the Reynolds-averaged 
Navier-Stokes equations. The spatial discretization involves a semi-discrete finite-volume 
approach. Upwind-biasing is used for the convective and pressure terms, while central dif- 
ferencing is used for the shear stress and heat transfer terms. Time advancement is implicit 
with the ability to solve steady or unsteady flows. Multigrid and mesh sequencing are 
available for convergence acceleration. Numerous turbulence models are provided, includ- 
ing 0-equation, 1 -equation, and 2-equation models. Multiple-block topologies are possible 
with the use of 1-1 blocking, patching, overlapping, and embedding. CFL3D does not con- 
tain any grid generation software. Grids must be supplied extraneously. 

Version 5.0 of CFL3D has several additional utilities over earlier versions of the code. 
Most notably. Version 5.0 has the capability to employ sliding patched-zone interfaces, 
such as might be required to perform rotor-stator computations, for example. However, it 
is stressed here that CFL3D has been developed primarily as a tool for external aerody- 
namics analysis. Its use for internal turbomachinery applications has been only as a basic 
research code thus far; other Navier-Stokes codes specifically designed for turbomachin- 
ery applications, such as ADPAC 22 , UncleTurbo 23 , or ROTOR 29 may be better suited to the 
analysis of such flows. 

The purpose of this user’s manual is to describe the code and provide instruction for its 
usage. Chapter 2 explains the set up and running of the code. Various files available with 
CFL3D are described and directions for their usage are provided. Step by step instructions 
are listed for running CFL3D, as well as the pre-processing codes needed for grid-overlap- 
ping and patching. 
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Chapter 3 provides a line-by-line description of all the input parameters utilized in 
CFL3D. This will probably be the chapter referred to the most. It will aid users in under- 
standing the sample problems as well as in setting up their own problems. While some 
parameters are strictly case dependent, some are fairly general and recommended values 
are usually indicated. Certain problems may, of course, require altering the recommended 
values of these parameters as well. 

To avoid the use of feet, meters, pounds, grams, etc. in coding the equations, CFL3D 
solves the Navier-Stokes equations in “nondimensional” form. Each flow-field parameter 
is nondimensionalized by reference values. For example, all points on a wing may be non- 
dimensionalized by the chord length of the wing. The nondimensionalizations used in 
CFL3D are described in Chapter 4. 

Chapter 5 explains the file formats. The most important of these is the grid file format, 
since users will need to translate their grids into an appropriate CFL3D format. The restart 
file format may be needed for user-designed post-processing programs. This chapter also 
describes the various output files. 

Besides providing general information about boundary condition usage in CFL3D, 
Chapter 6 discusses the various physical boundary conditions available. It also provides 
descriptions of the multiple block capabilities in CFL3D, mainly, 1-1 blocking, patching, 
grid overlapping, and grid embedding. Input examples for the various techniques are pro- 
vided. 

The advantages of using multigrid for convergence acceleration are explained in 
Chapter 7. The theory behind multigrid and its usage are discussed. The use of multigrid 
with embedded grids is described. Mesh sequencing is also defined and discussed. Input 
examples are provided there as well. 

Chapter 8 discusses time accurate simulation of unsteady flows using sub-iteration 
schemes. Two types of sub-iterations are currently implemented in CFL3D. The effects of 
the different types of sub-iterations, as well as the strategy for pursuing time-accurate 
computations in general, are described. 

Chapter 9 contains several test cases for the user to practice with when learning how to 
run CFL3D. Two-dimensional sample cases include a single block RAE airfoil case, a 
grid-overlapping NACA 0012 airfoil case, a patched grid NACA 0012 airfoil case, and a 
grid-overlapping multielement airfoil case. Also described are examples for a fixed flat 
plate, a vibrating plate, a multistream nozzle, and a rotor-stator. The three-dimensional test 
cases include an axisymmetric bump, a single block F-5 wing, a single block ONERA M6 
wing, and a single block delta wing. 

Finally, Chapter 10 is dedicated to troubleshooting. It is basically a compilation of 
suggestions for common problems encountered by users over the years. It is recommended 
that this chapter be read at the onset of any difficulties which occur while using CFL3D. 
Precious time may be saved by learning from the experiences (and, yes, the mistakes!) of 
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others. It is prudent at this point to suggest to the user that any problems encountered 
while using CFL3D be reported to the support personnel so that others may benefit from 
hitherto unknown experiences that may occur. 

There are several appendices at the end of this manual which provide more detailed 
information about the code. Appendix A describes the governing equations. Appendix B 
explains the time advancement procedure. The spatial discretizations of the inviscid and 
viscous fluxes are described in Appendix C. The multigrid algorithm is described in 
Appendix D. The matrix needed to convert the equations from conservative variables to 
primitive variables is derived in Appendix E. A step-by-step explanation of how to convert 
the governing equations from Cartesian coordinates to generalized coordinates is provided 
in Appendix F. Appendix G shows how the forces and moments are calculated. 
Appendix H describes the turbulence models available in CFL3D. Appendix I illustrates 
the angle (a and P ) definitions used in the code. Appendix J contains a list of all the sub- 
routines in CFL3D and their purposes. Finally, Appendix K explains the differences 
between Versions 4.1 and 5.0 of CFL3D. 

The last two sections of the manual are source listings. Beginning on page 337, there is 
a partial list of papers that have been published over the years as CFL3D has developed. 
The last section of the manual is a list of the references used for this document. 

It is appropriate at this point to discuss some of the terminology used in the CFL3D 
User’s Manual. Terms, such as grid, zone, mesh, and block, are often used interchange- 
ably in CFD discussions and literature. For clarity in this manual, the following distinc- 
tions are defined. The grid refers to those sets of points that define the flow field and are 
generated by the user to be read in by CFL3D. A grid may be one entity or it may be com- 
posed of several component grids. These component grids may also be called grid zones. 
The grid zones may communicate with one another through 1-1 blocking, patching, over- 
lapping, or embedding. The term block is used for bookkeeping purposes. All component 
grids are blocks and are assigned a block number. The grid or the set of component grids is 
often referred to as the global grid, encompassing the entire flow field. When the compo- 
nent grids are coarsened for such options as multigrid and mesh sequencing, the coarser 
levels are labelled as blocks and are also assigned block numbers. Embedded grids are 
finer than the component grid in which they reside, but do not encompass the entire zone. 
Instead, they are placed in regions known to have high gradients to further resolve those 
areas. 

Another terminology definition that should be clarified is the phrase free stream. As 
used throughout this manual, the words free stream imply a reference state. CFL3D was 
developed primarily as an external flow solver, in which case the appropriate reference 
state is free stream. However, for purely internal flows, the concept of free stream has no 
meaning and the more general concept of reference state should be used. 

Further distinctions between terms are required in discussing the methods of commu- 
nication between blocks. When two blocks share a face or a portion of a face and the grid 
points correspond point to point, the boundary condition communication set up between 
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the two blocks is called 1-1 blocking. The blocks in this case re often referred to as being 
C° continuous. Grid patching, on the other hand, refers to the boundary condition interpo- 
lations set up between blocks that share a common face or portion of a face, but which do 
not match point to point. For example, a fine grid face of one block could pass flow infor- 
mation to a coarse grid face of another block as long as the two blocks shared the face. 
Grid overlapping has neither the restriction of point to point connectivity or a common 
face between blocks. For example, a cylindrical “inner” grid could communicate with a 
cubic “outer” grid even though the grid topologies are completely different. The terms 
overset grids and chimera grids are synonymous with overlapped grids. 

A distinction should also be made for the methods of time advancement. The term time 
accurate means that the flow is actually tracked in time. For example, if the flow is 
allowed to advance for ten seconds, the flow conditions at a certain point in the flow field 
might have ten different values, one at each second. For a steady state problem, after con- 
vergence is reached, the flow conditions will not change with time. 

Here is one final tip for reading this manual. In discussions and examples, input vari- 
ables are typed in bold print. Such items as variable names, array names, lines of actual 
code, input samples, etc. are printed in the courier font. Note that these conventions do 
not necessarily convey in the World-Wide-Web version of this manual. The CFL3D inter- 
net address is: http://fmad-www.larc.nasa.gov/~rumsey/CFL3D/cfl3d.html . 

Hopefully, this manual will answer most questions encountered when running CFL3D. 
If problems arise that are not addressed in the sample inputs or in Chapter 10, please con- 
tact 


Dr. Christopher L. Rumsey 
(757)864-2165 
c.l.rumsey@larc.nasa.gov 


or 

Dr. Robert T. Biedron 
(757)864-2156 
r.t.biedron@larc.nasa.gov 


NASA Langley Research Center 
Mail Stop 128 
Hampton, VA 23681-0001 

Please also let these representatives know if any “bugs” or other useful insights are discov- 
ered during the usage of CFL3D. 
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Every effort has been made to insure that this document represents the correct usage 
and theoretical underpinnings of CFL3D. The intention has been to make this manual as 
complete and as self-consistent as possible. However, no guarantee can be given that this 
manual covers all possible aspects of the code and its usage or that this manual is without 
error. 
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Getting Started 




While the ultimate goal in utilizing CFL3D will be to solve problems pertinent to the 
user’s work, it is highly recommended for new users to begin by running some of the test 
cases described in Chapter 9. Experience gained while running these will help the user 
when running a “real” problem. The following sections provide general instructions for 
compiling and running CFL3D. 


2.1 Acquiring the Code and Example Files 

The files needed to run CFL3D are located on Vonneumann and Eagle, two Cray 
supercomputers located at NASA Ames Research Center. The files are in 

~rumsey/Cf 13dv5/ cf 13dv5 .ascii 

The files are tarred, compressed, encrypted, and uuencoded. A keyword (obtained from 
the Aerodynamic and Acoustic Methods Branch at NASA Langley - see below) must be 
used to decode the file cf I3dv5 . ascii. The steps for this procedure are as follows: 

Step. L 

uudecode cfl3dv5 . ascii 

Step 2 

crypt keyword < cf!3dv5 . crypt > cf 13dv5 . tar . Z 


Step 3 

uncompress cf 13dv5 . tar . Z 


Step 4 

tar xvf cfl3dv5.tar 

This step should create a directory named Cfl3dv5 with the appropriate CFL3D files in it. 

Step 5 

rm cf!3dv5 . ascii cf!3dv5.tar cf!3dv5 . crypt 
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If the test cases are not required, a more convenient option might be to obtain the file 
cfi3dv5.codeoniy. ascii. This file is also tarred, compressed, encrypted, and uuen- 
coded, but it is much smaller than cfi3dv5 .ascii. 

If access to Vonneumann or Eagle is not possible, the encrypted codes are also avail- 
able on the Langley CFD anonymous ftp site. To obtain the code in this manner, take the 
following steps: 

Step l 

ftp tabdemo.larc.nasa.gov 


or 

ftp 128.155.24.42 

Step 2 

When prompted for the username, type 

anonymous 

Step 3 

Type the user’s e-mail address as the password. 



cd incoming 


cd Rumsey 


Step 6 

get cf!3dv5 . ascii 


or 


get cf 13dv5 . codeonly . ascii 

To obtain the current keyword needed to decode the source files, send mail or e-mail to 
Dr. Christopher L. Rumsey (see page 4) requesting the code, along with an explanation 
describing the planned usage of the code. Include a FAX number with the request. All 
users will be asked to fill out and sign a CFL3D Usage Agreement form. After the com- 
pleted form is received, the keyword will be provided. 

After obtaining CFL3D, it is required that the user remember not to distribute any part 
of the code to others outside of his or her own working group without prior permission 
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from NASA Langley. The CFL3D code is currently restricted to use within the United 
States only. 


2.1.1 The Code and Supplementary Files 

The items listed below are made available to the user when CFL3D is obtained. The 
names in bold face indicate a directory. 


2dtestcases 

isrcheq_wkstn . f 

makepreef 1 3 d_hp_sng 1 

3dtestcases 

Ibex . f 

makeprec f 1 3 d__r s 6 00 0 

Advice 

makec f 1 3 d_c ray 

makeprec f 1 3 d_sgi 

Maggie 

makeef 13d_decalpha 

makepreef 13d_sgi_Rl 00 00 

Multitask_cray 

ma k e c f 1 3 d_hp_db 1 

makeprec f 1 3 d_sgi_R8 00 0 

README 

makec f 1 3 d_hp_sng 1 

makeprec f 1 3d_sun 

Ronnie 

makeef 13d__rs 6000 

plot3d_hp_dbl . f 

Tools 

makeef 13d_sgi 

preef 1 .h 

af 3 f . f 

makec f 1 3 d_sgi_Rl 0000 

preef 13d . f 

be . f 

makeef 13 d_sgi_R8 000 

rhs . f 

cbsem. f 

makeef 13 d_sun 

second_hp_dbl . f 

cvmgt_wkstn . f 

makepreef 13d_c ray 

second_rs6000 . f 

dynptch . f 

makepreef 13d_decalpha 

second__wkstn . f 

input . doc 

makeprec f 1 3d_hp_dbl 

turbs . f 


The CFL3D code consists of one main driver subroutine package, cbsem. f, and six 
sets of library subroutines, bc.f, rhs.f, af3f.f, lbcx.f, turbs.f, and dynptch.f. 
cbsem. f contains the main subroutine (mgblk) of the program as well as many of the rou- 
tines needed for the input and output of information. The file be . f contains the boundary 
condition subroutines, including physical boundary conditions, 1-1 blocking, and grid 
embedding. It also contains the necessary routines for processing supplemental over- 
lapped-grid and static patched-grid interpolation information. Rhs . f contains the subrou- 
tines needed for solving the right-hand side of the governing equations, while af3f.f 
contains the subroutines needed for calculating the left-hand side of the governing equa- 
tions. (See Appendix A.) Lbcx . f contains a variety of subroutines, including those needed 
for multigrid and mesh sequencing, those providing the metrics and other grid informa- 
tion, those involved with computing the forces, and several others. The file turbs . f con- 
tains the turbulence models subroutines. Finally, dynptch.f contains the subroutines 
needed for dynamic grid patching. 

Some supplementary files are also needed for CFL3D. A “makefile” is used to compile 
and link subroutines and to create an executable for the code. A preprocessing program 
called preef 13d . f is used to determine the memory and array dimensions needed by 
CFL3D for a particular case. For precfl3d.f, use makeprecfl3d_machinename. Here, 
and in the discussions that follow, the terms in italics pertain to user-specific items. For 
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instance, machinename might be cray, sgi # or sun for the Cray supercomputer, SGI, and 
Sun workstations, respectively. Precfl.h is the parameter file required by this makefile. 
The array dimensions set in precf 1 . h should be large enough for nearly any problem and 
should rarely need modification; if a larger value of a particular parameter is required, 
precf 13d will stop and request the user to increase the relevant parameter. 

A makefile called makecfl3d_jnacfri.nena.me is also needed to compile and link the 
CFL3D subroutines and create the executable, cfl3d. Several files are needed to compile 
the code on workstations. These files contain Fortran source code for the corresponding 
Cray intrinsic functions. For instance, when utilizing makecf I3d_rs6000, make sure that 
second_rs 60 00 . f is available. Likewise, when using makecf 13d_hp_dbl, make sure that 
p l o 1 3 d_hp_db 1 . f and s e c o n d_hp_db l . f are in the working directory. Note that for dou- 
ble precision on the HP, the user must actually remove the subroutines plot3d, plot3c, 
and plot3t from cbsem.f prior to compiling with makecf 13d_hp_dbl. For all other 
makecf 13d makefiles, cvmgt_wkstn. f, isrcheq_wkstn . f , and second_wkstn . f are uti- 
lized and therefore must be available. (Note that wkstn is short for “workstation”.) 

The file input . doc contains the information found in Chapter 3. It is a listing and 
description of the input parameters used in CFL3D. 

The files in directory 2dtestcases are: 

0012_patch Flatplate 

0012_xmera Multielem 

README. 2d Multistream 

The files in directory 3dtestcases are: 

README. 3d Delta Oneram6 

Axibump F5wing 

Directory 2dtestcases contains various two-dimensional test cases. A patching 
example involving the NACA 0012 airfoil is located in ooi2_patch. In ooi2_xmera, a 
case utilizing grid overlapping for the same airfoil is found. A three-element airfoil case 
involving grid overlapping is set up in Multielem. Directory Raeio contains a single 
block case for the RAE 2822 airfoil. Flatplate contains the files needed to run the flat 
plate test case. A multistream nozzle case is in Multistream. In vibrate are the files for 
a vibrating plate case. A rotor-stator case is set up in Rotor. 

The three-dimensional test cases are located in the directory 3dtestcases. A case 
solving the flow over an axisymmetric bump is in Axibump. Other cases currently available 
are for a delta wing (in Delta), an F-5 wing (in FSwing), and an Onera M-6 wing (in 
0neram6). The steps for running these test cases are described in Chapter 9. 


RaelO 

Rotorstator 

Vibrate 
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2.1.1 The Code and Supplementary Files 


The files in directory Advice are: 

cf 13dadvice . give cf 13d . ref erences v4_to__v5 . inputdif 

cf 13dadvice .grid cf 13d . turb. references 


The first four files contain the same information given in Chapter 10 and in "CFL3D 
Papers” on page 337. The v4_to_v5 . inputdif file describes the differences between the 
Version 4.1 and Version 5.0 input files. (This information is also given in Appendix K.) 


The files in directory Maggie are: 


README 

ismax_wkstn . f 
ismin_wkstn . f 
magi . h 


maggie . doc 
maggie . f 
makemaggie_cray 
makemagg i e_hp_sng 1 


makemaggie_sgi 
makemaggie_sun 
second_wkstn . f 


The files in the Maggie directory are needed for cases involving grid overlapping. The 
chimera scheme code is called maggie. f. Maggie.doc explains the input parameters for 
maggie. f. Makefiles for various machines are available and require magi .h, which con- 
tains the appropriate dimensions for the problem at hand. Make sure ismax_wkstn. f, 
ismin_wkstn. f, and second_wkstn . f are available before running MaGGiE on a work- 
station. 

The files in Multitask_cray are: 


README makecf 13d_cray_multi xlim_multi.f 

fhat_multi . f tinvr_mult i . f 


These files should be used in conjunction with the standard CFL3D files when Cray 
multitasking is desired. 


The files in directory 

README 

makeronnie_cray 

makeronnie_decalpha 

makeronnie_hp_sngl 


Ronnie are: 

maker onnie_sgi 
makeronnie_sun 
ronl .h 
ronnie . doc 


ronnie . f 
second_wkstn . f 


When utilizing grid patching, the files in the Ronnie directory are needed. The code 
that sets up the patching interpolation stencils is called ronnie. f. Ronnie.doc explains 
the input parameters for ronnie. f. Makefiles for various machines are available and uti- 
lize ronl . h in the compilation. The user must set the parameters in ronl . h for each par- 
ticular case. Also, make sure second_wkstn. f is available before running ronnie on a 
workstation. 
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The files in the Tools directory are: 


README 

everyother . f 
everyotherp3d . f 
historytec3d . f 


makeltol . f reverseijk.f 

make_p3dtotec3d_cray v4tov5_input . f 
p3dtotec3d. f v4tov5_restart . f 

p3dtotec3d_pre . c v5inpdoubhalf . f 


These programs are useful for converting files from one format to another. The code 
everyother . f takes an existing CFL3D-type grid and coarsens it by taking every other 
grid point. The everyotherp3d. f program performs the same task for PLOT3D-type 
grids. The file historytec3d. f reads in the residual history file and creates a correspond- 
ing Tecplot 4 file. It will also convert iterations to work units if desired. The makeltol . f 
program assists in the creation of the boundary condition and one-to-one blocking sections 
of the input file. The p3dtotec3d.f tool (along with P 3dtotec3d_pre .c and 
make_p3dtotec3d_cray) creates a Tecplot file from PLOT3D grid and solution files. The 
reverseijk. f code reads a CFL3D-type grid file, swaps indices (as desired), and writes 
out a new CFL3D-type grid file. The v4tov5_input . £ tool takes a Version 4.1 input file 
and converts it to Version 5.0 form. The v4tov5_restart . f tool converts a Version 4.1 
restart file to Version 5.0 form. Finally, v5inpdoubhaif . f takes an existing input file and 
creates a new input file with either double or half the grid points of the original. 


2.2 Obtaining a Grid File 

The first step in solving a CFD problem is obtaining a grid. A pre-packaged tool such 
as GRIDGEN 36 could be used to create a grid, or perhaps a user- written program could be 
used for relatively simple configurations. How ever the grid is obtained, an essential step 
toward success with CFL3D will be having the grid file written in CFL3D or PLOT3D/ 
TLNS3D format. See “Grid File” on page 65 for the appropriate formats for the file. Time 
can also be saved at this point by considering what options will be desirable later. For 
example, since the use of multigrid is highly recommended, choose grid dimensions 
wisely. See “A Word About Grid Dimensions” on page 127. If viscous cases will be run, 
make sure the grid spacing normal to the wall in the boundary layer is fine enough. At 
least 20 grid points are recommended in a laminar boundary layer. At least 3 points are 

recommended in the laminar sub-layer of a turbulent boundary layer (y of first grid point 
off the wall should be 0(1)). Basically, consider how the problem will be solved and 
choose dimensions, blocking strategies, grid-line stretching, etc., accordingly. 


2.3 Creating the Input File 

Chapter 3 lists and describes all the parameters in the input file. The easiest way to cre- 
ate an input file for a particular case is to copy the input file from the test case (see 
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Chapter 9) most resembling the case at hand. Then change those parameters that pertain to 
the current case. The other parameters should already be set to the recommended values. 
Besides the test case sample inputs, some input examples for 1-1 blocking and grid 
embedding are provided in Chapter 6 and several input examples for multigrid, mesh 
sequencing, and grid embedding are provided in Chapter 7. CFL3D provides additional 
help in setting up the input file with an extensive set of diagnostics which halt execution at 
detectable errors and provide the user with a message indicating the problem. 


2.4 Utilizing Patched and/or Overlapped Grids 

When using patched and/or overlapped grids, the files containing the appropriate inter- 
polation coefficients must be obtained prior to running CFL3D. The preprocessors ronnie 
and MaGGiE 11 will generate the needed coefficients for patched grids and overlapped 
grids, respectively, and will output the interpolation information in the format needed by 
CFL3D. Information on using ronnie and MaGGiE can be found in the ronnie.doc and 
maggie.doc files, respectively. The preprocessor precfi3d, which sets all the array size 
parameters needed by CFL3D, will need the appropriate patch and/or overlap data files in 
order to properly size the arrays needed for these options. Therefore, be sure to run ronnie 
and/or MaGGiE before running precf 13d. 


2.4.1 Running ronnie 

When utilizing the grid patching option of CFL3D, the preprocessor ronnie must be 
run first. The basic steps for running this code are as follows. 

Step l 

Prepare an input deck, typically called ronnie . inp, for the case. Also, modify the header 
file roni .h as needed. 

Step 2 

Use the makefile to compile, link, and create the executable for the ronnie code (be sure 
roni . h is in the current directory): 

make -f makeronni e_wachinename 

Step 3 

Run the ronnie code: 

ronnie < ronnie. inp 

If successful, ronnie will create a file containing patch interpolation data. The name of the 
patch file is specified by the user in the input file; it is typically called patch . bin. 
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2.4.2 Running MaGGiE 

If grid overlapping is used in some portion of the grid configuration, then the prepro- 
cessor MaGGiE must be utilized. The basic steps for running this code are as follows. 

Step l 

Prepare an input deck, typically called maggie . inp, for the case. Also, modify the header 
file magi .h as needed. 

Step 2 

Use the makefile to compile, link, and create the executable for the MaGGiE code (be sure 
magi .h is in the current directory): 

make - f makemaggi e^machinename 

Step 3 

Run the MaGGiE code: 

maggie < maggie. inp 

If successful, MaGGiE will create a file containing overlap interpolation data. The name 
of the overlap file is specified by the user in the input file; it is typically called ovrlp . bin. 


2.5 Running CFL3D 

The basic steps for running CFL3D are as follows. Remember, if using grid patching 
and/or grid overlapping, run ronnie and/or MaGGiE before proceeding with the following 
steps. 

Step L 

Compile, link, and create the executable for the precfl3d. f code. Make sure the param- 
eter file precf l . h is available. 

make -f makeprecf 136_machinename 

The resulting executable will be called precf 13d. 

Step 2 

Run precf 13d. 

precfl3d < input filename 

The input filename here is the CFL3D input file name. Detailed diagnostic information 
is printed out in the file precf 13d. out . Most items in the input deck will be checked for 
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consistency. However, since precfl3d does not read in the grid file, it cannot detect grid 
problems and, most importantly, it cannot detect ordering errors in the 1-1 block inter- 
faces. Check the output from CFL3D itself to verify that 1-1 block interfaces are set cor- 
rectly. If precf 13d has not run successfully, then the most likely cause is an error in the 
input file; precfi3d echoes the input file as it goes along, so check the bottom of 
precf 13d . out to determine the approximate location of the input error. A successful exe- 
cution of precf 13d will have one of the following lines at the end of the output file and 
print to the screen: 

you *MUST* recompile cfl3d 


or 


you do not need to recompile cfl3d 

When the code has run successfully, there will be no further need for this program until a 
new input file is developed. 

Running precfl3d will either create or modify the parameter files, cfll.h, cfl2.h, 
cf 13 . h, cf 14 . h, and cf 15 . h, which are used when compiling CFL3D. Remember that 
these files are case dependent. Therefore, another case will generally require that 
precf 13d be run again and CFL3D recompiled. 

Step. 1 

Compile, link, and create the executable for CFL3D. 

make -f makecf 13d_ma chin ename 
The executable will be called cfi3d. 

Step 4 

Run cf 13d. This step can be performed interactively or a submittal file can be utilized 
to send the case to a particular queue of the machine being used. 

cfl3d < input filename 

Users have been known to submit cases for large numbers of iterations on the first run 
only to discover that an input parameter was set incorrectly. It is wise to begin running 
CFL3D with only a few iterations and then check the output. Look over the main output 
file. Make sure there are no warning messages and that, in general, it “looks right” for the 
particular case being run. Take the PLOT3D files to a Silicon Graphics (or compatible) 
workstation and check any block boundaries to see if the flow is passing from block to 
block as expected. Then submit the case for a more extensive computation. 
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CHAPTER 3 


Input Parameters 



Descriptions of each of the input line types are provided in this chapter where the sec- 
tion numbers denote the line type (LT) number referred to throughout the manual. An 
example input file is provided below for a flat plate case. Note that not all of the line types 
of information will be required for every application. 

I/O FILES 
grdf lat 5 . bin 
piot3dg . bin 
plot 3dq . bin 
cf 13d . out 
cf 13d . res 
cf 1 3d . turres 
cf 13d. blomax 
cf 13d. outl5 
cf 13d . prout 
cf 13d . out2 0 
ovrlp . bin 
patch.bin 
restart . bin 


turbulent flat plate (plate from j=17-65, prior to 17 is symmetry) 


XMACH 

ALPHA 

BETA 

REUE.MIL 

T INF, DR 

IALPH 

IHSTRY 


0.2000 

00.000 

0,0 

06.000 

460.0 

0 

0 


SREF 

CREF 

BREF 

XMC 

YMC 

ZMC 



1.00000 

1.00000 

1.0000 

0.00000 

0.00 

0.00 



DT 

IREST 

IFLAGTS 

FMAX 

IUNST 

CFLTAU 



-5.000 

0 

000 

05.0000 

0 

10.0 



NGRID 

NPLOT3D 

NPRINT 

NWREST 

ICHK 

I2D 

NTSTEP 

ITA 

1 

1 

0 

1200 

0 

1 

1 

1 

NCG 

I EM 

I ADVANCE 

IFORCE 

IVISC(I) 

IVISC (J) 

IVISC (K) 


2 

0 

0 

001 

0 

0 

7 


IDIM 

JDIM KDIM 






02 

65 

97 






ILAMLO 

ILAMHI 

JLAMLO 

JLAMHI 

KLAMLO 

KLAMHI 



1 

2 

1 

17 

1 

97 



INEWG 

IGRIDC 

IS 

JS 

KS 

IE 

JE 

KE 

0 

0 

0 

0 

0 

0 

0 

0 

IDIAG(I) 

IDIAG(J) 

IDIAG (K) 

IFLIM(I) 

IFLIM(J) 

IFLIM(K) 



1 

1 

1 

0 

0 

0 



IFDS(I) 

IFDS { J) 

IFDS (K) 

RKAP0 (I) 

RKAP0 (J) 

RKAP0 (K) 



1 

1 

1 

0.3333 

0.3333 

0.3333 



GRID 

NBC 10 

NBCIDIM 

NBC JO 

NBCJDIM 

NBCK0 

NBCKDIM 

IOVRLP 

1 

1 

1 

1 

1 

2 

1 

0 

10: GRID 

SEGMENT 

BCTYPE 

JSTA 

JEND 

KSTA 

KEND 

NDATA 

1 

1 

1001 

0 

0 

0 

0 

0 

IDIM: GRID 

SEGMENT 

BCTYPE 

JSTA 

JEND 

KSTA 

KEND 

NDATA 

1 

1 

1002 

0 

0 

0 

0 

0 

JO : GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

KSTA 

KEND 

NDATA 

1 

1 

1008 

0 

0 

0 

0 

0 

JDIM : GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

KSTA 

KEND 

NDATA 

1 

1 

1002 

0 

0 

0 

0 

0 

K0: GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

JSTA 

JEND 

NDATA 

1 

1 

1001 

0 

0 

1 

17 

0 

1 

2 

2004 

0 

0 

17 

65 

2 


TWTYPE 

CQ 







0 . 

0 . 






KDIM : GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

JSTA 

JEND 

NDATA 

1 

1 

1003 

0 

0 

0 

0 

0 
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MSEQ 

MG FLAG 

ICONSF 

MTT 

NGAM 



1 

1 

0 

0 

02 



ISSC 

EPSSSC(l) 

EPSSSC ( 2 ) 

EPSSSC (3) 

ISSR 

EPSSSR (1) 

EPSSSR (2 ) 

0 

0.3 

0.3 

0.3 

0 

0.3 

0.3 

NCYC 

MGLEVG 

NEMGL 

NITFO 




0800 

03 

00 

000 




MIT1 

MIT2 

MIT3 

MIT4 

MIT 5 

MIT6 

MIT7 

01 

01 

01 

01 

01 

1 

1 


1-1 BLOCKING DATA: 


NBLI 

0 

NUMBER GRID : 

NUMBER GRID : 

PATCH SURFACE DATA: 
NINTER 
0 

PLOT3D OUTPUT: 

GRID IPTYPE I START 
10 0 
IMOVIE 
0 


ISTA 

ISTA 

JSTA 

JSTA 

KSTA 

KSTA 

IEND 

IEND 

JEND 

JEND 

KEND 

KEND 

ISVA1 

ISVAl 

IEND 

0 

I INC 
0 

JSTART 

0 

JEND 

0 

JINC 

0 

KSTART 

0 

KEND 

0 


EPSSSR ( 3 ) 
0.3 


MIT8 

1 


ISVA2 

ISVA2 


KINC 

0 


PRINT OUT : 

GRID IPTYPE I START I END I INC J START JEND JINC KSTART KEND KINC 

CONTROL SURFACE: 


NCS 

0 

GRID ISTART IEND J START JEND KSTART KEND IWALL INORM 


3.1 LT1 - Input/Output File Names 

Input/Output file names, up to 60 characters each, starting in column 1. Specify the user 
file names in the following order (one name per line), using a “dummy’ file name if a file 
is not actually needed for the current problem: 


Input/Output File File Typ e 

grid (unit 1) binary [1] input 

PLOT 3D grid (unit 3) binary [2] ' [3] output 

PLOT3D solution (unit 4) binary [2U31 output 

primary case information (unit 11) ascii output 

residual and force coefficient history (unit 12) ascii output 


turbulence model residual history {not Baldwin-Lomax) (unit 13) . . . ascii output 


Baldwin-Lomax (unit 14) ascii output 

secondary case information (unit 15) ascii output 


[ 1 ] Defaulted in the code to standard binary for the particular machine on which the code is executed. On Cray comput- 
ers the default can be changed to IEEE Big unformatted by uncommenting “call asnf lie” one line prior to the open 
statement for unit 1 in the main routine. 

[21 Defaulted in the code to standard binary for the particular machine on which the code is executed. On Cray comput- 
ers the default can be changed to IEEE Big unformatted by uncommenting the “call asnfilc” lines one line prior to 
the open statements for both unit 3 and unit 4 in the main routine. 

[31 Can be changed to formatted by changing the open statements for unit 3 and unit 4 to “formatted” and changing 
ibin from 1 to 0 in subroutine qout. 
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3.2 LT2 - Case Title 


flow-field variables printout (unit 17) ascii output 

unsteady pressures from forced oscillations (iunst > 0) (unit 20) ... . ascii output 

interpolation coefficients for chimera grids (unit 21) binary input 

interpolation coefficients for patched grids (unit 22) binary input 

restart (unit 2) binary input/output 


3.2 LT2 - Case Title 

title describing case 


3.3 LT3 - Flow Conditions 
xmach - free-stream^ Mach number 

alpha - angle of attack (See Appendix I.) 

beta - side-slip angle (See Appendix I.) 

reue - free-stream [4] Reynolds number per unit grid length (millions) 

How to Set reue 

Suppose it is desired to simulate a flow in which the Reynolds number 
based on some characteristic length (e.g. the chord) is Re . If L is the cor- 
responding length in the grid (ignore the dimension, if any, of L ), then set 
reue = Re/L . For example, if unit “1” in the grid corresponds to “1 inch” 
in the experiment, then give reue as the Reynolds number per inch. If unit 
“1” in the grid corresponds to “16.7845 furlongs”, then give reue as the 
Reynolds number per 16.7845 furlongs. (Also remember that in the input 

file, reue/lxlO 6 is the actual input value, so put a “20” for “20 million”, 
etc.) (See “Reynolds Number Examples” on page 55.) 

tinf - free-stream [41 temperature (degrees Rankine) 

ialph - indicator for determining how angle of attack is measured in PLOT3D- 

type grids (ngrid < 0) 

If Then 

ialph = 0 alpha is measured in the x-z plane (with z “up”), i.e. 

alpha =90° would give a free-stream velocity vector in 
the positive z direction. 


[4] See the note on page 3 about the usage of the phrase free stream. 
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ialph > 0 alpha is measured in the x-y plane (with y “up”), i.e. 

alpha = 90° would give a free-stream velocity vector in 
the positive y direction. 

Note 

(1) For CFL3D-type grids, alpha is always measured in the x - z plane, 
with z “up”. (If it is desired to have y “up” with CFL3D-type grids, 
then set ialph > 0 and comment out the following line in subroutine 
global: 

if (ngrid.gt.O) ialph=0 

ihstry — determines which variables are to be tracked for a convergence history 

(i.e., which variables are output to file cfi3d.res (unit 12) and file 
cfl3d.subit.res (unit 23)) 

If Then 

ihstry = 0 standard convergence history: residual, C { , C d , C y or C z 
depending on whether z or y is “up”, respectively, and 
C my or C mz (for z or y “up”, respectively) 

ihstry > 0 control surface history: residual and mass flow, pressure 
force, viscous force, thrust (momentum) force (forces are 
resultant forces, i.e. if f x , f y , and f z are the force compo- 
nents in the x , y , and z directions, then the resultant force 

is Jf 2 + f 2 y + f z ; must have ncs > 0 and specify which 

control surfaces are to be tracked - only those surfaces 
with inorm 0 are included in the sum) 

Note 

(1) “LT3 - Flow Conditions” of CFL3D Versions 4.1 and earlier had addi- 
tional parameters isnd and c2spe to govern wall temperature and heat 
transfer. These parameters are no longer used, but their functions are 
implemented in a more general fashion in boundary condition type 
2004. (See notes under “LT14 - 10 Boundary Condition Specification” 
on page 32). The position formerly occupied by isnd is now occupied 
by ialph, so that the value of ialph for PLOT3D-type grids is no 
longer hard-wired in subroutine rp3d (as in earlier versions of the 
code). 


3.4 LT4 - Reference Quantities 

sref — reference area used to compute non-dimensional forces and moments; 

sref is generally taken to be the plan-form area ( not the wetted area) of a 
wing, for example. It should be given in grid dimensions. (You must also 
account for the grid-distance between 2-D planes when i2d=l !) 
cref - reference length used to compute non-dimensional moments 


I 1 1 


20 CFL3D User’s Manual 


3.5 LT5 - Time Step Parameters 

bref - reference span used to compute non-dimensional moments 

xmc - moment center in x direction 

ymc - moment center in y direction 

zmc - moment center in z direction 


3.5 LT5 - Time Step Parameters 

dt - time step 

If Then 

dt < 0 local time stepping, CFL number = Idtl; Use ncyc to con- 

trol the number of cycles. Sub-iterations are not used, 
dt > 0 constant time step equal to dt; Use ntstep to control the 

number of time steps and ncyc to control the number of 
sub-iterations. Two different sub-iteration strategies can be 
employed: t-TS and x-TS. The t -TS method can have 
unacceptable time-step limitations depending on the case. 
The x-TS method allows for much larger time steps, 
although larger time steps require more sub-iterations. 
Multigrid may be used to enhance convergence of sub- 
iterations and is recommended in general. 


li 

Then 


t-TS 

ntstep 

= number of time steps 


ita 

= +1 or +2 (+2 recommended) 


mgflag 

= 0 or 1 (1 recommended) 


mglevel 

= number of multigrid levels 


ncyc 

= number of sub-iterations + 1 
(typically from 2 to 15) (ncyc = 1 
will yield standard time-accurate 
method with no sub-iterations.) 

x-TS 

ntstep 

= number of time steps 


ita 

= -1 or -2 (-2 recommended) 

(See “LT6 - Options and Specifica- 
tions” on page 23) 


mgflag 

= 0 or 1 (1 recommended) 


mglevel 

= number of multigrid levels 


ncyc 

= number of sub-iterations + 1 


(typically from 5 to 25) 
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Notes 

(1) The number of sub-iterations required depends partly on the size of 
the physical time step used. More sub-iterations are required for 
larger time steps. The use of multigrid will generally reduce the num- 
ber of sub-iterations required, although the cost per sub-iteration will 
increase. 

(2) It is strongly recommended that the sub-iteration convergence be 
monitored in the output file cfl3d.subit_res to determine if suffi- 
cient sub-iterations are being used for a particular case. The residual 
should drop and the force coefficients should tend toward constant 
values during each sub-iteration. However, from an efficiency stand- 
point, it is not generally desirable to fully converge each time step. 

(3) The x-TS scheme utilizes, in addition to the physical time step, a 
“pseudo” time step based on local time stepping. Thus, there is a CFL 
number associated with x -TS (see cfl_tau on page 23). 

(4) See “Time and Time Step” on page 56 for the nondimensionalization 
of the time step. 

(5) To obtain second order accuracy in time (lital = 2), sub-iterations 
(ncyc > 1) must be used. 

irest - restart flag 

If Then 

irest = 0 no restart 

irest > 0 restart from previous solution, using restart file (unit 2) 

irest < 0 restart from previous solution, but do not save previous 

history information 

iflagts - time step ramping flag 

If Then 

iflagts = 0 constant dt 

iflagts >0 dt ramped over iflagts steps to dt x fmax 

fmax - maximum increase in dt; dt final = fmax x dt inilial 

Notes^ 

(1) The ramping of the time step/CFL number to dt final is non-linear, 
occurring slowly at first and then increasing in rate. 

(2) When the time step has successfully been ramped to dt final , remem- 
ber to set the input value of dt to dt fina) before restarting with the 

previous solution. Also, remember to change iflagts to zero and/or 
fmax to 1 .0. 

iunst - unsteady mesh flag 

If Then 

iunst = 0 stationary grid 

iunst = 1 dynamic grid (translation or rotation) 
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Notes 


cfl tau 


3.6 LT6 

ngrid 

npIot3d 


nprint 


nwrest 


3.6 LT6 - Options and Specifications 


(1) If dt < 0, iunst is automatically set to 0. 

(2) See “LT33 - Number of Translated Grids” on page 43 and beyond for 
specification of dynamic grid input. 

- CFL number for x -TS scheme; cfl_tau is always > 0 and it is not used for 
the t-TS scheme (ita > 0) or non-time-accurate runs (dt < 0). A value in 
the range from 5 to 10 is recommended; however, a smaller value may be 
required if the sub-iterations do not converge. 


Options and Specifications 

- number of grids input = abs(ngrid) 

If Then 

ngrid > 0 CFL3D grid format 

ngrid < 0 PLOT3D (or TLNS3D) grid format 

(See “Grid File” on page 65.) 

- number of flow-field data sets to be output in PLOT3D format 

Note ± 

(1) If nplot3d < 0, then the PLOT3D files are automatically set to include 
all solid surfaces (no field points) for 3-d cases or all field points for 
2-d cases. 

(2) If nplot3d < 0, do not input any PLOT3D data lines in the PLOT3D 
input section below (“LT28 - PLOT3D Output Specifications”), that 
is, if np!ot3d < 0, treat the PLOT3D input section as if nplot3d = 0. 

- number of data sets to be sent to an output file 

Note s_ 

(1) If nprint < 0, then the printout file is automatically set to include all 
solid surfaces (no field points) for 3-d cases or all field points for 2-d 
cases. 

(2) If nprint < 0, do not input any print out data lines in the print out 
input section below (“LT30 - Print Out Specifications”), that is, if 
nprint < 0, treat the print out input section as if nprint = 0. 

- number of iterations between updates of the binary restart file (Note that 
the binary restart file is also updated at the last iteration of the run regard- 
less of the value of nwrest.) Must be > 0. Used to save an earlier restart 
file in case the full run does not finish. Generally, set nwrest > ncyc (or > 
ntstep for time-accurate) unless it is suspected that the run may not fin- 
ish, or for a margin of safety. Restart file is overwritten each time it is 
updated. 
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ichk - checks for negative densities and/or pressures in subroutines gfluxr, 

hf luxr, f fluxr, and conu if set equal to 1. 

Note 

(1) Checking for negative densities and/or pressures requires additional 
CPU time, so utilize only to diagnose problem cases. 

i2d - 2-d case flag 

If Then 

i2d = 0 3-d case 

i2d = 1 2-d case 

i2d = -1 2-d case plus far-field point- vortex correction for bctype = 

1003 

Notes 

(1) For i2d 0, must set idim = 2. 

(2) For i2d * 0, the i = 1 and i = 2 planes must each be planar. 

(3) For i2d = -1, the grid must be the x-z plane; the point vortex is 
applied at (xmc, zinc). 

ntstep - number of cycles for time-accurate computations (dt > 0) 

Notes 

(1) For time-accurate computations, ncyc controls the number of sub-iter- 
ations. 

(2) For steady-state computations (dt < 0), ntstep defaults to 1 and ncyc 
controls the number of cycles. 

ita - order of time-accuracy/two-time scheme flag (used only for dt > 0) 

If 

ita = +1 
ita = +2 

ita = -1 

ita = -2 

Notes 

(1) The approximate factorization scheme used to advance the solution in 
time introduces first order errors in time. Furthermore, if the diagonal 
version is utilized (idiag = 1), additional errors of order At are intro- 
duced. Sub-iterations can be used to drive these factorization/diago- 
nalization errors to zero. Therefore, if a formally second-order (in 
time) solution is desired, sub-iterations must be used; the run will ter- 
minate if lital > 1 and ncyc = 1. 

(2) The overhead for second order verses first order is relatively small 
when compared to the gain in accuracy and is therefore recom- 
mended. 


Then 

first order in time; physical time term only (r-TS method) 
second order in time; physical time term only (r-TS 
method) 

first order in time; physical and pseudo time terms (t-TS 
method) 

second order in time; physical and pseudo time terms (T- 
TS method) (recommended) 
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(3) The inclusion of a pseudo time term increases (often dramatically) the 
maximum allowable time step one can take for a particular problem. 
However, sub-iterations (ncyc > 1) are therefore mandatory and mul- 
tigrid is recommended. Also, note that larger time steps imply greater 
temporal error; so again, second order is recommended. 


3 . 7 LT7 - Grid, Force, and Viscous Options 

(Data for Line Type Seven should be repeated ngrid times.) 

ncg - number of coarser grids to construct for multigrid and/or mesh sequenc- 

ing (Set ncg = 0 for an embedded mesh.) 

Note 

(1) With the exception of embedded grids, all grids should have the same 
value of ncg. 

iem - embedded mesh flag 

If Then 

iem = 0 global grid 

iem = 1 level number (1) of this embedded grid above the global 

grid level 

iadvance - flag to initiate residual/update calculations 
If Then 

iadvance > 0 evaluate the residual and update the solution in the current 
block 

iadvance < 0 skip the residual/update calculations for the current block 
(rarely used) 

iforce - flag to initiate the calculation of forces on block faces with solid surfaces; 

iforce is a 3-digit number of the form IJK: 

Where Initiates 

1 = 0 no force calculations on the i faces 
1=1 calculation of the force contribution from the i = 1 face 

1 = 2 calculation of the force contribution from the i = idim face 

1 = 3 calculation of the force contributions from both the i = 1 face 
and the i = idim face 

J = 0 no force calculations on the j faces 
J = 1 calculation of the force contribution from the j = 1 face 

J = 2 calculation of the force contribution from the j = jdim face 

1 = 3 calculation of the force contributions from both the j = 1 face 
and the j = jdim face 

K = 0 no force calculations on the k faces 
K = 1 calculation of the force contribution from the k = 1 face 
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ivisc(m) 


K = 2 calculation of the force contribution from the k = kdim face 

K = 3 calculation of the force contributions from both the k = 1 face 

and the k = kdim face 

Notes 

(1) Only solid surfaces contribute to the force computations; i.e. only 
those boundaries with boundary condition types 1005 and 2004 can 
contribute to the force totals. Thus, wakes (with boundary condition 
type 0) are not computed in the force total, regardless of whether or 
not they are on a boundary that has been flagged with iforce > 0. 

(2) The iforce parameter indicates the calculations of force contributions 
from entire faces; i.e. iforce * 0 will cause all segments on that partic- 
ular face to contribute to the force total (assuming those segments 
have solid-surface boundary conditions, as discussed previously). To 
eliminate from the force computation a segment that would otherwise 
contribute to the force total, set segment < 0 in “LT14 - 10 Boundary 
Condition Specification” on page 32 through “LT19 - KDIM Bound- 
ary Condition Specification” on page 35. This will eliminate that par- 
ticular segment from the total. This feature is useful, for example, 
when the fuselage and sting are both on the k = 1 boundary of grid 1 . 
The force contribution from the fuselage is desired, but not the contri- 
bution from the sting. In this case, let the k = 1 boundary be defined 
by two segments (the first for the fuselage and the second for the 
sting). Set iforce = 001 for grid 1 and then set segment = -2 for the 
second segment in “LT18 - K0 Boundary Condition Specification”, 
e.g.: 

K0 : GRID SEGMENT BCTYPE ISTA I END JSTA JEND NDATA 

1 1 2004 1 97 0 0 2 

1 -2 2004 97 129 002 


- viscous/inviscid surface flag with m = 1, 2, 3 => m = i, j, k 
If Then 

ivisc = 0 inviscid 
ivisc = 1 laminar 

ivisc = 2 turbulent -Baldwin-Lomax model 

ivisc = 3 turbulent -Baldwin-Lomax with Degani-Schiff modification 

ivisc = 4 turbulent -Baldwin-Barth model 

ivisc = 5 turbulent -Spalart-Allmaras model 

ivisc = 6 turbulent -Wilcox k-c o model 

ivisc = 7 turbulent -Menter’s k-c o SST model 

ivisc = 8 turbulent -k-c o Explicit Algebraic Stress Model Gatski- 
Speziale (EASM Gatski-Speziale) in eddy-viscos- 
ity formulation 

ivisc = 9 turbulent - k - e EASM Girimaji in eddy-viscosity formula- 
tion 

ivisc = 10 turbulent -Abid k - e model 
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ivisc =11 turbulent - k - e EASM Gatski-Speziale Nonlinear 
ivisc =12 turbulent —k — co EASM Gatski-Speziale Nonlinear 
ivisc =13 turbulent -k - £ EASM Girimaji Nonlinear 
Notes 

(1) If ivisc(m) < 0 on input, a wall function is employed. This option 
should only (officially) be used for attached flow, when the first grid 

point off the wall is not in the sub-layer (y + > 10 or more). The wall 
function with the Baldwin-Lomax model (ivisc = -2 or -3) can be 
particularly non-robust and, although it may sometimes work well, it 
is not recommended in general. 

(2) The thin-layer viscous terms (laminar or turbulent) can be included in 
the j , k , or i directions, either separately or combined. Cross-deriva- 
tive terms are not included. The exception is for turbulent flow using 
the Baldwin-Lomax model; terms can be included simultaneously in, 
at most, two directions, either j — k or i - k , for any particular grid. 

(3) Unlike previous versions of the code, the Baldwin-Lomax model can 
now be applied at any boundary or boundaries; i.e., the walls may 
now be at j / k / i = 1 and/or j/ k / i = jdim/kdim/idim. 

(4) For multiple-zone applications, be aware that the Baldwin-Lomax 
model is not a field-equation model and it relies on distances to jl k / 
i = 1 and/or j/ k / i = jdim/kdim/idim walls in a given zone. If a par- 
ticular zone does not contain walls but it is still desired that ivisc = 2 
or 3 there, the model will default to using a length scale associated 
with a distance to the nearest j / k / i = l face in that zone. Another 
option is to set ivisc = 0 or 1 in the zones with no walls, but this may 
not be viable if the zone in question is very near to a wall(s) in other 
zones. 

(5) For the reasons listed above, the field-equation modes 4 and up, which 
use the very general minimum distance function (which finds the min- 
imum distance to the nearest wall, regardless of what zone it is in) are 
generally preferred, especially in multi-zone applications. However, 
the Baldwin-Lomax model (with the Degani-Schiff option) still seems 
to be the best model for vortical flows. 

(6) It is preferable to let k be the primary viscous direction and i be the 
secondary viscous direction. See discussion in Section 5.1.1. If i is 
used as a primary viscous direction, it may be necessary to switch the 
order of inversions in subroutine af3f (e.g. from j,k,i to j ,i ,k). 
Keep in mind that, unlike i and k , altering the location of the j inver- 
sion in the approximate factorization sequence requires substantial re- 
coding. 
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(7) The minimum distance function smin is computed from viscous walls 
only. If a wall is inviscid, then as far as smin is concerned, it is invisi- 
ble. This is important to remember when viscous boundary conditions 
are turned on after running a case inviscidly for some time since smin 
may never have been computed! 

Caution 

The EASM models are currently very preliminary and should be consid- 
ered as “researcher-oriented” as opposed to “production-oriented”. Due 
to the sensitive nature of the variable coefficient emu, the models are gen- 
erally less robust than other models (particularly for 3-d cases and partic- 
ularly for the nonlinear versions). It is recommended that EASM 
solutions be restarted from previously converged k - (0 or k - £ solutions 
for this reason. Even then, certain cases may still experience trouble! 
However, preliminary tests indicate that the Girimaji EASM k - e model 
(ivisc =13) tends to be the most robust of the EASM models. 


3.8 LT8 - Grid Dimensions 

(Data for Line Type Eight should be repeated ngrid times.) 

idim - number of grid points in the i direction (must be 2 for Ii2dl =1) 

jdim - number of grid points in the j direction 

kdim - number of grid points in the k direction 


3.9 LT9 - Laminar Region Specification 

(Data for Line Type Nine should be repeated ngrid times.) 

ilamlo - lower i grid point index defining the laminar region of the current block 

ilamhi - upper i grid point index defining the laminar region of the current block 

jlamlo - lower j grid point index defining the laminar region of the current block 

jlamhi - upper j grid point index defining the laminar region of the current block 

klamlo - lower k grid point index defining the laminar region of the current block 

klamhi - upper k grid point index defining the laminar region of the current block 

Notes 

(1) These parameters are used for simulating transition only if ivisc > 1. 
Set ilamlo, jlamlo, klamlo = 0 for fully turbulent flow. Currently, 
only one transition region per grid is allowed. 
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(2) When ilamlo, etc. are used, they define a region inside which the pro- 
duction terms in the turbulence model equations (for ivisc > 3) are 
turned “off’ (for the Baldwin-Lomax model, the eddy viscosity is 
merely zeroed out). The flow usually remains laminar inside that 
region as a result. In contrast, “fully turbulent” (ilamlo, etc. = 0) 
means that the production terms in the turbulence model equations are 
“on” everywhere. However, in practice, one might see behavior which 
indicates that the model is still “transitioning” on its own. In other 
words, one might see a low “laminar” Cj near the leading edge of an 

airfoil, transitioning fairly rapidly to a higher “turbulent” Cy , for 

example. Note that turning off the production term does not keep tur- 
bulence from convecting into a region, if turbulence exists upstream. 

(3) Currently for multigrid, the turbulent viscosity is only computed on 
the finest level grid, then it is restricted to coarser levels. Therefore, 
the ilamlo, etc. values need not be “good” multigrid numbers when 
used. 


3.10 LT10 - Embedded Mesh Specifications 

(Data for Line Type Ten should be repeated ngrid times.) 

inewg - restart flag for grid (not needed if irest = 0) 

If Then 

inewg = 0 flow-field data is read from the restart file 
inewg = 1 flow-field data is initialized by linear interpolation from 
coarser grid solutions 

Notes 

(1) The purpose of inewg is to allow embedded grids to be added after the 
solution process has begun; that is, if a solution has already been 
computed, but additional resolution in certain parts of the flow field is 
desired. In such cases, embedded grids may be appended to the grid 
file and the case may be restarted. Setting inewg = 1 initializes the 
solution on the new embedded level by interpolating from a solution 
on a coarser level, thereby providing a reasonable starting solution on 
the new embedded level (the solution for the new embedded grid is 
not contained in the restart file at this point). 

(2) Important: inewg should be set to 1 only for the first restart after a 
new embedded level has been added. On subsequent restarts, inewg = 
0 should be used, since the embedded solution has become part of the 
restart file and should not be re-initialized. 

igridc - connection flag for embedded meshes 

If Then 

igridc = 0 the current grid is a global mesh (iem = 0) 
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igridc > 0 igridc is the grid number to which the embedded mesh 
(iem > 0) connects 

is, js, ks - starting indices in the connecting grid for placement of an embedded 
mesh (set is = 0, js = 0, ks = 0 for global meshes) 

ie, je, ke - ending indices in the connecting grid for placement of an embedded 
mesh (set ie = 0, je = 0, ke = 0 for global meshes) 

Note 

(1) The embedded meshes must be a regular refinement in all directions 
of the grid to which it connects. The exception is in the i direction for 
which the embedded mesh may have the same grid spacing as the grid 
to which it connects if desired (this ensures that idim = 2 for all grid 
levels in 2-d cases, including embedded grid levels). 


3.1 1 LT1 1 - Matrix Inversion and Flux Limiter 

(Data for Line Type Eleven should be repeated ngrid times.) 

idiag(m) - matrix inversion flag with m = 1, 2, 3 => m = i, j, k 
If Then 

idiag = 0 5x5 block tridiagonal inversions 

idiag = 1 scalar tridiagonal inversions 

Notes 

(1) The scalar tridiagonal inversions are recommended for steady-state 
computations. They may or may not be appropriate for time-accurate 
computations. For time-accurate computations with scalar tridiagonal 
inversions, it is suggested that sub-iterations be used to reduce the 
diagonalization errors. 

(2) When idiag = 0, viscous terms are included on the left-hand side of 
the implicit time advancement scheme in the k direction only. 

iflim(m) - flux limiter flag with m = 1 , 2, 3 => m = i,j,k 


If 

Then 

iflim = 0 

unlimited 

iflim = 1 

smooth limiter 

iflim = 2 

min-mod limiter (recommended if limiter is needed and 

iflim = 3 

rkapO * 1/3) 

smooth limiter tuned to K = 1/3 with a cut-off to eliminate 

Notes 

limiting in regions of small gradients (recommended if 
limiter is needed and rkapO = 1/3) 


(1) Many purely subsonic flows do not require a limiter. 

(2) Use of iflim = 3 will override the rkapO value input and force 
upwind-biased third order. 
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3.12 LT12 - Spatial Differencing 

(Data for Line Type Twelve should be repeated ngrid times.) 

ifds(m) - spatial differencing parameter for Euler fluxes with 

m = 1,2,3 => m = i, j, k 
If Then 

ifds = 0 flux-vector splitting 

ifds = 1 flux-difference splitting (Roe’s scheme) (recommended) 

rkapO(/n) - spatial differencing parameter for Euler fluxes with 
m = 1, 2, 3 => m = i, j, k 
If Then 

rkapO = -1 fully upwind 

rkapO = 0 Frommes’ scheme 

rkapO = 1 central 

rkapO = 1/3 upwind-biased third order (recommended) 


3.13 LT13 - Boundary Condition Segments 

(Data for Line Type Thirteen should be repeated ngrid times.) 
boundary condition segment flags: 
grid - current grid number (must be in order) 

nbciO - number of segments on i =0 boundary 

nbcidim - number of segments on i = idim boundary 

nbcjO - number of segments on j = 0 boundary 

nbcjdim - number of segments on j = jdim boundary 

nbckO - number of segments on k = 0 boundary 

nbckdim - number of segments on k = kdim boundary 

iovrlp - grid-overlapping flag 

If Then 

iovrlp = 0 no overlapping occurs for the current grid 

iovrlp = 1 the current grid receives data from an overlapped grid(s) 

Note 

(1) The minimum number of segments on any boundary is 1. 
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3.14 LT14 - 10 Boundary Condition Specification 

ngrid 

(Data for Line Type Fourteen should be repeated ^ nbciO(n) times.) 

n = 1 

10 Boundary: 

grid - current grid number (must be in order) 

segment — current segment (must be in order and the total must equal nbciO) 
bctype - boundary condition type for the current segment 

jsta - j starting grid point location for the current segment 

jend - j ending grid point location for the current segment 

ksta - k starting grid point location for the current segment 

kend - k ending grid point location for the current segment 

ndata - number of additional data values required for this boundary condition 

Notes 

OTSetting jsta = jend = 0 and/or ksta = kend = 0 is a shorthand way of 
specifying the entire range of j and/or k for this segment. 

The following notes pertain to “LT14 - 10 Boundary Condition Specifica- 
tion” on page 32 through “LT19 - KDIM Boundary Condition Specifica- 
tion” on page 35: 

(2) If ndata > 0, then, following the current line, a header line must 
appear, followed by a single line with the ndata values for this bound- 
ary condition. 

(3) When multigrid is being used, it is best if all segment lengths are also 
multigridable. This is not a requirement. However, if one-to-one con- 
nections are involved, it is possible that the use of non-multigridable 
segment lengths will result in geometric mismatches on coarser grid 
levels, causing a “mismatch” message to be written to unit 1 1 and, 
most likely, eventual disruption of the execution. 

(4) If a particular segment should not be counted in the force total, set 
segment to be negative. (See Note (2) under iforce in Section 3.7.) . 

(5) Input values for bctype (i.e. boundary condition types currently sup- 
ported) as follows: 


bctvDe 

boundary condition 

1000 

free stream 

1001 

general symmetry plane 

1002 

extrapolation 

1003 

inflow/outflow 

1004 

(no longer available, use 2004 instead) 
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1005 

inviscid surface 

1008 

constant enthalpy and entropy inflow 

1011 

singular axis - half-plane symmetry 

1012 

singular - full plane 

1013 

singular axis - partial plane 

2002 

specified pressure ratio 

2003 

inflow with specified total conditions 

2004 

no-slip wall 

2005 

periodic in space 

2006 

set pressure to satisfy the radial equilibrium equation 

2007 

set all primitive variables 

2102 

pressure ratio specified as a sinusoidal function of time 


Descriptions of the boundary conditions can be found in Chapter 6. 


3.15 LT15 - ID1M Boundary Condition Specification 

ngrid 

(Data for Line Type Fifteen should be repeated nbcidim(n) times.) 

n = ] 

IDIM Boundary: 

All entries in this line type are the same as in “LT14 - 10 Boundary Condition Specifica- 
tion” except: 

segment - current segment (must be in order and the total must equal nbcidim) 


3.16 LT16 - JO Boundary Condition Specification 

ngrid 

(Data for Line Type Sixteen should be repeated ^ nbcjO(n) times.) 

n - 1 

JO Boundary: 

grid - current grid number (must be in order) 

segment - current segment (must be in order and the total must equal nbcjO) 

betype - boundary condition type for the current segment 

ista - i starting grid point location for the current segment 

iend - i ending grid point location for the current segment 

ksta - k starting grid point location for the current segment 

kend - k ending grid point location for the current segment 
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ndata - number of additional data values required for this boundary condition 

Notes 

(1) Setting ista = iend = 0 and/or ksta = kend = 0 is a shorthand way of 
specifying the entire range of i and/or k for this segment. 

(2) See general notes in “LT14 - 10 Boundary Condition Specification”. 


3.17 LT17 - JDIM Boundary Condition Specification 

□ grid 

(Data for Line Type Seventeen should be repeated ^ nbcjdim(n) times.) 

n = 1 

JDIM Boundary: 

All entries in this line type are the same as in “LT16 - JO Boundary Condition Specifica- 
tion” except: 

segment - current segment (must be in order and the total must equal nbcjdim) 


3.18 LT18 - K0 Boundary Condition Specification 


ngrid 

(Data for Line Type Eighteen should be repeated ^ nbckO(n) times.) 

n - 1 


K0 Boundary: 

grid 

segment 

bctype 

ista 

iend 

jsta 

jend 

ndata 


- current grid number (must be in order) 

- current segment (must be in order and the total must equal nbckO) 

- boundary condition type for the current segment 

- / starting grid point location for the current segment 

- i ending grid point location for the current segment 

- j starting grid point location for the current segment 

- j ending grid point location for the current segment 

- number of additional data values required for this boundary condition 
N otes 

(TySetting ista = iend = 0 and/or jsta = jend = 0 is a shorthand way of 
specifying the entire range of i and/or j for this segment. 

(2) See general notes in “LT14 - 10 Boundary Condition Specification”. 
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3.19 LT 19 - KDIM Boundary Condition Specification 

ngrid 

(Data for Line Type Nineteen should be repeated nbckdim(n) times.) 

n = I 

KDIM Boundary: 

All entries in this line type are the same as in “LT18 - KO Boundary Condition Specifica- 
tion” except: 

segment - current segment (must be in order and the total must equal nbckdim) 


3.20 LT20 - 

Mesh Sequencing and Multigrid 

mseq 

— mesh sequencing flag for global grids (maximum number of grid levels 


for mesh sequencing is 5) 


If 

Then 


mseq = 1 

single solution on the finest grid level 


mseq = 2 

solution on the second finest grid advanced ncyc(l) cycles, 
followed by ncyc(2) cycles on the finest grid. The initial 
solution on the finest grid is obtained by interpolation 
from the coarser grid solution. If ncyc(2) = 0, the compu- 
tations are terminated on the second finest grid after 
ncyc(l) cycles and the restart file is written for the second 
finest grid. 


mseq > 2 

sequencing from coarsest to finest mesh as above 

mgflag 

- multigrid flag 


If 

Then 


mgflag = 0 

no multigrid 


mgflag = 1 

multigrid on coarser global meshes 


mgflag = 2 

multigrid on coarser global meshes and on embedded 
meshes 

iconsf 

- conservation 

flag 


If 

Then 


iconsf = 0 

nonconservative flux treatment for embedded grids 


iconsf = 1 

conservative flux treatment for embedded grids 

mtt 

- flag for additional iterations on the “up” portion of the multigrid cycle 


If 

Then 


mtt = 0 

no additional iterations (recommended) 


mtt > 0 

mtt additional iterations 

ngam 

- multigrid cycle flag 


If 

Then 


ngam = 1 

V-cycle 


ngam = 2 

W-cycle (not recommended for overlapped grids) 
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Note 

(1) If mglevg = 2, ngam defaults to 1. 

3.21 LT21 - Smoothing 

issc - correction smoothing flag 

If Then 

issc = 0 no correction smoothing (usually recommended, but see 

note 18 in Chapter 10) 
issc = 1 correction smoothing 

epsssc(m) - correction smoothing coefficient with m = 1,2, 3 => m = i, j, k ; 
typical values: 0.3, 0.3, 0.3 

issr - residual smoothing flag 

If Unn 

issr = 0 no residual smoothing (usually recommended, but see note 
18 in Chapter 10) 
issr = 1 residual smoothing 

epsssr(An) - residual smoothing coefficient with m = 1, 2, 3 => m = i, j, k ; typical 
values: 0.3, 0.3, 0.3 


3.22 LT22 - Iterations and Multigrid Levels 

(Data for Line Type Twenty-Two should be repeated for each sequence 1 through mseq (from coarsest to 

finest).) 

ncyc - number of cycles for steady-state computations (dt < 0); number of sub- 

iterations + 1 for time-accurate computations (dt > 0) 

Notes 

(1) Set ncyc > 1, unless using mesh sequencing and terminating execution 
on a coarser grid level (see description of mseq = 2 for “LT20 - Mesh 
Sequencing and Multigrid” on page 35, as well as “Mesh Sequenc- 
ing” on page 134). 

(2) For time-accurate computations (dt > 0), when ncyc = 1, the code is 
iterating on each time step once, which means no sub-iterations - are 
used. Using ncyc = 1 corresponds to the standard non-sub-iterative 
time-accurate scheme that was in all previous versions of CFL3D. 
Similarly, ncyc = 2 means that the code is iterating on each time step 
twice, which means sub-iterations are used, since it is one extra sub- 
iteration over the standard non-sub-iterative time- accurate scheme. 

(3) For time-accurate computations (dt > 0) with multigrid (mgflag > 0), 
at least one sub-iteration must be used (ncyc > 2). 
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3.23 LT23 * Coarse Grid Iterations 


mglevg 


nemgl 


nitfol 


- number of grids to use in multigrid cycling for the global meshes 

If Then 

mglevg = 1 single grid level 

mglevg = 2 two grid levels 

mglevg = m m grid levels 

- number of embedded grid levels above the finest global grid 

If Then 

nemgl = 0 no embedded grids 

nemgl = 1 one embedded grid 

nemgl = m m embedded grids 

Note 

(1) Set nemgl = 0 for global grids coarser than the finest global grid. 

- number of first order iterations (nitfol = 0 recommended) 


3.23 LT23 - Coarse Grid Iterations 

(Data for Line Type Twenty-Three should be repeated for each sequence 1 through mseq (from coarsest to 
finest).) 

mitL - iterations on level L for each level L from coarsest to finest (mitL = 1 

recommended, in general, although for some cases 3 2 1 or 2 2 1 can 
yield better multigrid convergence than 1 1 1 when three levels are used, 
for example) 


3.24 LT 24 - Number of 1-1 Interfaces 

nbli - number of 1-1 grid-point-connecting block interfaces 


3.25 LT25 -1-1 Blocking Connections 

(Data for Line Type Twenty-Five should be repeated nbli times.) 

number - identifying number to aid the user with “bookkeeping” the 1-1 interfaces 
in the input file (not used by CFL3D) 

grid - grid/block identifier indicating which grid in the common interface is 

being described in this line of input 

ista - starting i limit for 1-1 block interface 

jsta - starting j limit for 1-1 block interface 

ksta - starting k limit for 1-1 block interface 
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iend - ending i limit for 1-1 block interface 

jend - ending j limit for 1-1 block interface 

kend - ending k limit for 1-1 block interface 

isval — varying index on 1-1 block interface (isval in Line Type Twenty-Five 

varies with isval in Line Type Twenty-Six) 

isva2 — varying index on 1-1 block interface (isva2 in Line Type Twenty-Five 

varies with isva2 in Line Type Twenty-Six) 

Notes 

(1) The code will check the input connection data by computing the geo- 
metric mismatch between both sides of the interface, based on the 
specified ranges. A true 1-1 interface will have zero (or machine zero) 
mismatch. Any mismatches larger than E (where e is the larger of 

10” 9 and 10 times machine zero) will cause a warning message to be 
printed out in the main output file (look for the words “geometric 
mismatch”. Always check the main output file (unit 11) for these 
words, since the code will only print out the message; it will not stop. 
A good practice is to make one run with only one iteration, then check 
the output for “geometric mismatch”. Small mismatches may be 
acceptable, but large mismatches [0(1)] most likely indicate that one 
of the segments on the block boundary has been specified incorrectly. 

(2) Any block segments that have 1-1 connectivity must also be input in 
the boundary condition section (“LT13 - Boundary Condition Seg- 
ments” on page 31 through “LT19 - KDIM Boundary Condition 
Specification” on page 35), setting bctype = 0. 


3.26 LT26 -1-1 Blocking Connections 

(Data for Line Type Twenty-Six should be repeated nbli times.) 

Line Type Twenty-Six has the same parameter types as Line Type Twenty-Five. It gives 
the grid/block 1-1 connection information on the opposite side of the interface. 


3.27 LT27 - Number of Patched-Grid Interfaces 

ninter - patched-grid flag (zonal interface along a common surface where points 

need not match) 

If Then 

ninter = 0 no patched-grid data is needed (no patched interfaces) 

ninter < 0 patched-grid data supplied in a separate file 
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3.28 LT28 - PLOT3D Output Specifications 

Notes 

(1) In Version 5.0 of CFL3D, patched-grid interpolation data for static 
patched interfaces (interfaces that do not change with time) must be 
obtained as a preprocessing step (as for chimera overlapped grids). 

The code ronnie is designed for this task. Dynamic patched interfaces 
(such as occur when blocks slide past one another) are computed 
internally to CFL3D. The input for dynamic patched interfaces is 
described in “LT41 - Number of Dynamic Patched-Grid Interfaces” 
on page 49 through “LT45 - Displacement and Rotation Amounts” on 
page 52. 

(2) Any block segments that are patched must also be input in the bound- 
ary condition section (“LTD - Boundary Condition Segments” on 
page 31 through “LTD - KDIM Boundary Condition Specification” 
on page 35), setting bctype = 0. 


3.28 LT28 - PLOT3D Output Specifications 

(Data for Line Type Twenty-Eight should be repeated nplot3d times.) 

grid - designated grid number for output 

iptype - type of PLOT3D file output 

Then 

iptype = 0 grid point type - grid file and Q file output 

iptype =1 cell center type - grid file and Q file output 

iptype = 2 cell center type - grid file and turbulence file output (ivisc 

> 1 only) (The current defaults for output are the produc- 

~ 3 

tion term P • L^/{u m ) and the Reynolds stress compo- 
nents m , w , /(m oo ) 2 , uu'/{uj ^ , and w'w ' /(«„) 2 for2-d; 

and the same plus Sk/e for 3-d. (See Ristorcelli 30 for a 
description of these and other available variables.) These 
may be modified to output other variables if the user 
desires. If no turbulence model is being used or if the tur- 
bulence model cannot obtain a specific parameter being 
asked for, a value of zero is output. The “hard wire” occurs 
in subroutine plot3t. Note that the v' , and w' quanti- 
ties are aligned with the x, y, and z axes of the grid, 
respectively. 

iptype > 2 cell center type - grid file and PLOT3D function file out- 
put 

Specific functions currently available: 

iptype = 3 minimum distance to nearest viscous wall or directed dis- 
tance (ivisc > 1 only) 

iptype = 4 eddy viscosity (ivisc > 1 only) 
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istart 

- starting location in i direction 

iend 

- ending location in i direction 

iinc 

- increment factor in i direction 

jstart 

- starting location in j direction 

jend 

- ending location in j direction 

jinc 

- increment factor in j direction 

kstart 

- starting location in k direction 

kend 

- ending location in k direction 

kinc 

- increment factor in k direction 


Notes 

(1) Setting istart = iend = iinc = 0, jstart = jend = jinc = 0, and/or kstart 
= kend = kinc = 0 is a shorthand way of specifying the entire range of 
i , j and/or k , respectively. 

(2) Grid files are written with a blank array. 

(3) All files are in multi-block format (even if there is a single zone). [ 

(4) Files are written as 2-d if i2d * 0. 

(5) Function files contain only one variable. 

(6) Files are written out in single precision. 

(7) On Cray computers, “uncommenting” the lines 

c call asnf ile (plt3dg, ' -F f77 -N ieee', IER) [ 

and 

c call asnf ile (plt3dq, ' -F f77 -N ieee', IER) , 

in module cbsem. f will cause the files to be written in IEEE binary. | 

The files may then be transferred directly to a Silicon Graphics work- 
station and read into FAST or PLOT3D using the unformatted option. 

If those lines are left as comments, then files are written in Cray 
native, and must first be “itransed” before being transferred to a Sili- 
con Graphics workstation and read into FAST or PLOT3D using the I 

default (binary) option. j 

(8) This output will appear in the PLOT3D files (units 3 and 4) named | 

near the top of the input deck. j 

I 

3.29 LT29 - Movie Option { 

movie — flag to append periodically to the PLOT3D output files (grid and solution) | 

as the solution progresses. Only one grid file and one solution file are * 

generated. j 

If Then ! 



3.30 LT30 - Print Out Specifications 


movie = 0 no output of intermediate solutions (if lnplot3dl > 0, then a 
single solution is written at the end of the run) 
movie > 0 output of additional solutions every movie iterations (the 
contents of the augmented PLOT3D files are governed by 
the parameters under “LT28 - PLOT3D Output Specifica- 
tions” on page 39) 

movie < 0 output of the initial flow field at the beginning of the run 
and output of additional solutions every Imoviel iterations 

Caution 

Use with care: PLOT3D files will get very large very quickly! If the com- 
plete flow field is output, this is really a viable option only in 2-d. In 3-d, 
it is generally a viable option only if subsets of the flow field are output 
(i.e. the surface data). Also, set nprint = 0 when movie > 0 or large print 
files will result as well. 


3.30 LT30 - Print Out Specifications 

(Data for Line Type Thirty should be repeated nprint times.) 

grid - designated grid number for output 

iptype - type of flow-field variables to print out 

If Then 

iptype = 0 grid point type 

iptype = 1 cell center type 

istart - starting location in i direction 

iend - ending location in i direction 

iinc - increment factor in i direction 

jstart - starting location in j direction 

jend - ending location in j direction 

jinc - increment factor in j direction 

kstart - starting location in k direction 

kend - ending location in k direction 

kinc - increment factor in k direction 

Notes 

(1) Setting istart = iend = iinc = 0, jstart = jend = jinc = 0, and/or kstart 
= kend = kinc = 0 is a shorthand way of specifying the entire range of 
i , j and/or k . 
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(2) This output will appear in the printout file (unit 17) named near the 
top of the input deck. 

Section 5.2.2 gives a detailed sample of the contents of the printout file. 

3.31 LT31 - Number of Control Surfaces 

ncs - the number of control surfaces; control surfaces are user-specified grid 

surfaces through which mass flow, thrust (momentum) force, pressure 
force, and viscous force may be monitored. Control surfaces must be 
specified if ihstry > 0. (See “LT3 - Flow Conditions” on page 19.) 


3.32 LT32 - Control Surface Specifications 

block - block number of the control surface 

istart - starting location in i direction 

iend - ending location in i direction 

jstart - starting location in j direction 

jend - ending location in j direction 

kstart - starting location in k direction 

kend - ending location in k direction 

iwall - control surface type 

If Then 

iwall = 0 for a flow surface 

iwall = 1 for a solid wall 

inorm - defines the direction of the control surface outward normal relative to the 

grid surface normal. This is only required in the calculation of the total 
forces for all control surfaces to obtain the correct signs. 

If Then 

inorm = 1 the control volume outward normal is in the same direc- 
tion as the grid surface normal 

inorm = -1 the control volume outward normal is in the opposite 
direction to the grid surface normal 

inorm = 0 do not add this surface into the summation of the total 
forces 

Notes 
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3.33 LT33 - Number of Translated Grids 


(1) The starting and ending indices in one of the directions must be iden- 
tical to define the surface. If they are not, no calculation is performed. 
In the remaining two directions, setting both the starting and ending 
indices to zero is a shorthand way of specifying the entire index 
range. 

(2) If all the surfaces have inorm = 0, the totals are not calculated. 

(3) This output will appear in the printout file named near the top of the 
input deck; the control surface data appears after the data generated 
by setting nprint > 0. 


THE INPUT DECK TERMINATES HERE FOR STEADY-STATE CASES OR TIME- 
DEPENDENT CASES IN WHICH THE GRID IS STATIONARY (iunst = 0) 


Line Types Thirty-Three through Forty-Five are required only if iunst > 0 (dynamic grid). 


3.33 LT33 - Number of Translated Grids 

ntrans - number of grids undergoing translation motion 

Notes 

(1) If ntrans = 0, only the headers for “LT34 - Translational Reference 
Length” on page 43 through “LT36 - Maximum Translational Dis- 
placements” on page 45 are required (i.e. no numerical values 
required). 

(2) If the moment center also needs to be translated, set ntrans = “num- 
ber of grids undergoing translation + 1”. If the moment center is not 
translated, moments are computed relative to a fixed point in space. 


3.34 LT34 - Translational Reference Length 

(Data for Line Type Thirty-Four should be repeated ntrans times.) 

Iref - the “grid equivalent” of the dimensional reference length used to define 

either the reduced frequency needed for itrans = 2 or the decay rate 
needed for itrans = 3 (See “LT35 - Translational Information and Veloci- 
ties” on page 44 below.) For itrans < 1, any value may be input (it is reset 
to 1.0 internally). 

Note 

(1) For example, if the input value of reduced frequency for a sinusoidally 
plunging wing was defined based on the dimensional chord of the 
wing and, in the grid, the chord of the wing is 2.0, then set lref = 2.0. 
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3.35 LT35 - Translational Information and Velocities 

(Data for Line Type Thirty-Five should be repeated ntrans times.) 

grid - designated number of grid to be translated 

Note 

(1) If grid = 0, then the following input governs the motion of the 
moment center; on output, the value of 0 will be replaced by the let- 
ters “MC” as a reminder. 


itrans 


rfreq 


utrans 


vtrans 


wtrans 


- type of translation 
If Then 

itrans = 0 no translation 

itrans = 1 translation with constant speed 
itrans = 2 sinusoidal variation of displacement 

itrans = 3 smooth increase in displacement, asymptotically reaching 

a maximum displacement 


- reduced frequency when itrans = 2; growth rate to maximum displace- 
ment when itrans = 3 (set rfreq = 0 for itrans = 0 or itrans = 1) 


- translation velocity in x direction when itrans = 1; maximum displace- 
ment in x direction when itrans > 1 (set utrans = 0 if there is no x dis- 
placement) 

- translation velocity in y direction when itrans = 1 ; maximum displace- 
ment in y direction when itrans > 1 (set vtrans = 0 if there is no y dis- 
placement) 

- translation velocity in z direction when itrans = 1; maximum displace- 
ment in z direction when itrans > 1 (set wtrans = 0 if there is no z dis- 
placement) 

Notes 

(1) Depending on the type of motion, the nondimensional input parame- 
ters listed above have different definitions and it is important to 
understand the distinction. These multiple definitions allow a range of 
grid motions with a minimal number of input parameters. 

(2) The sign of utrans/vtrans/wtrans governs the direction of the 
motion: “+” for motion in the increasing coordinate direction, for 
motion in the decreasing coordinate direction. For itrans = 2 (sinuso- 
idal), the sign dictates the “initial” direction of motion. 

Caution 
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3.36 LT36 - Maximum Translational Displacements 

If PLOT3D-type grids, where y is “up”, are used, it is important to note 
that the grid is internally treated as if z is “up” and that utrans, vtrans, 
and wtrans refer to the internal velocities. Thus, if y is “up” in the input 
grid and translation in the “up” direction is desired, then wtrans must be 
used to set the speed. It is advised that a visualization package such as 
FAST or PLOT3D be used in the early stages of the computation to verify 
that the grid is moving in the desired direction. 

3.36 LT36 - Maximum Translational Displacements 

(Data for Line Type Thirty-Six should be repeated ntrans times.) 

grid - designated number of grid to be translated 

Note 

(1) If grid = 0, then the following input governs the motion of the 
moment center; on output, the value of 0 will be replaced by the let- 
ters “MC” as a reminder. 

dxmax - maximum (absolute) translational displacement in the x direction to be 

allowed for this grid, measured from the t = 0 position; set dxmax = 0 
if no restriction is required 

dymax - maximum (absolute) translational displacement in the y direction to be 

allowed for this grid, measured from the t = 0 position; set dymax = 0 
if no restriction is required 

dzmax - maximum (absolute) translational displacement in the z direction to be 

allowed for this grid, measured from the t = 0 position; set dzmax = 0 
if no restriction is required 

Note 
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(1) Setting dxmax, dymax, and/or dzmax > 0 will have the following 
effect: if the grid moves further than Idxmaxl, Idymaxl, and/or 
Idzmaxl from its position at t = 0 , the grid will be reset backward 
the appropriate amount, from where the specified grid motion will 
start again. The grid will be reset every time it reaches the specified 
limit. Though each block may have an independent limit, care should 
be taken to insure that any blocks that must be reset concurrently have 
the same values of dxmax, dymax, and/or dzmax. This resetting fea- 
ture is used primarily in 2-d turbomachinery applications. For exam- 
ple, in 2-d rotor-stator interaction problems where only a few of an 
infinite number of rotor and stator blades are actually modeled in the 
grid system, resetting the grids periodically allows the simulation to 
be continued for an arbitrarily long period of time with only a limited 
number of zones. This resetting option is only applicable for constant 
translational speed (itrans =1). 


3.37 LT37 - Number of Rotational Grids 

nrotat - number of grids undergoing rotational motion 

Notes^ 

(1) If nrotat = 0, only the headers for “LT38 - Rotational Reference 
Length” on page 46 through “LT40 - Maximum Rotational Displace- 
ments” on page 48 are required (i.e. no numerical values required). 

(2) If the moment center also needs to be rotated, set nrotat = “number of 
grids undergoing rotation” + 1. 


3.38 LT38 - Rotational Reference Length 

(Data for Line Type Thirty-Eight should be repeated nrotat times.) 

lref - the “grid equivalent” of the dimensional reference length used to define 

either the nondimensional rotation rate needed for irotat = 1 , the reduced 
frequency needed for irotat = 2, or the growth rate needed for irotat = 3 
(See “LT39 - Rotational Information and Velocities” below.) For itrans < 
1, any value may be input (it is reset to 1.0 internally). 

Note_ 

(1) For example, if the input value of reduced frequency for a sinusoidally 
pitching wing was defined based on the dimensional chord of the 
wing and, in the grid, the chord of the wing = 2.0, then 
set lref = 2.0. 
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3.39 LT39 - Rotational Information and Velocities 

3.39 LT39 - Rotational Information and Velocities 

(Data for Line Type Thirty-Nine should be repeated nrotat times.) 

grid - designated number of grid to be rotated 

Note 

(1) If grid = 0, then the following input governs the motion of the 
moment center; on output, the value of 0 will be replaced by the let- 
ters “MC” as a reminder. 

irotat - type of rotation 

If Then 

irotat = 0 no rotation 

irotat = 1 rotation with constant angular speed 

irotat = 2 sinusoidal variation of angular displacement 

irotat = 3 smooth increase in displacement, asymptotically reaching 

a maximum angular displacement 

rfreq - reduced frequency when irotat = 2; growth rate to maximum angular dis- 

placement when irotat = 3 (set rfreq = 0 for irotat = 0 or irotat = 1) 

omegax — x component of rotational velocity when irotat = 1 ; maximum angular 
displacement about the x axis when irotat > 1; set omegax = 0 if there is 
no x rotation 

omegay - y component of rotational velocity when irotat = 1 ; maximum angular 
displacement about the y axis when irotat > 1; set omegay = 0 if there is 
no y rotation 

omegaz - z component of rotational velocity when irotat = 1 ; maximum angular 
displacement about the z axis when irotat > 1; set omegaz = 0 if there is 
no z rotation 

xorig - x coordinate of origin of the rotation axis 

yorig - y coordinate of origin of the rotation axis 

zorig - z coordinate of origin of the rotation axis 

Notes 

(1) Depending on the type of motion, the nondimensional input parame- 
ters listed above have different definitions and it is important to 
understand the distinction. These multiple definitions allow a range of 
grid motions with a minimal number of input parameters. (See 
Section 4.5.2 in the Nondimensionalization chapter for details.) 
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(2) The sign of omegax, omegay, and omegaz governs the direction of 
the rotation: “+” for motion in the positive direction, for motion in 
the negative direction where “positive” and “negative” are dictated by 
the right-hand rule in which the thumb points in the positive direction 
of the axis of rotation and the fingers curl in the positive rotational 
direction. (See “The Right-Hand Rule” on page 67.) 


3.40 LT40 - Maximum Rotational Displacements 

(Data for Line Type Forty should be repeated nrotat times.) 

grid - designated number of grid to be rotated 

Note 

(1) If grid = 0, then the following input governs the motion of the 
moment center. 

dthxmx — maximum (absolute) rotational displacement about the x axis to be 
allowed for this grid (set dthxmx = 0 if no restriction is required) 

dthymx - maximum (absolute) rotational displacement about the y axis to be 
allowed for this grid (set dthymx = 0 if no restriction is required) 

dthzmx — maximum (absolute) rotational displacement about the z axis to be 
allowed for this grid (set dthzmx = 0 if no restriction is required) 

Notes 

(1) Setting dthxmx, dthymx, and/or dthzmx > 0 will have the following 
effect: if the grid rotates more than Idthxmxl, Idthymxl, and/or 
Idthzmxl from it’s position at t - 0 , the grid will be reset backward 
the appropriate amount, from where the specified grid motion will 
start again. The grid will be reset every time it reaches the specified 
limit. Though each block may have an independent limit, care should 
be taken to insure that any blocks that must be reset concurrently have 
the same values of dthxmx, dthymx, and/or dthzmx. This resetting 
feature is used primarily in 3-d turbomachinery applications. For 
example, in 3-d rotor-stator interaction problems where only a few of 
the large number of rotor and stator blades are actually modeled in the 
grid system, resetting the grids periodically allows the simulation to 
be continued for an arbitrarily long period of time with only a limited 
number of zones. This resetting option is only applicable for constant 
rotational speed (irotat =1). 

(2) dthxmx, dthymx, and dthzmx are output in degrees. 
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3.41 LT41 - Number of Dynamic Patched-Grid Interfaces 


3.41 LT41 - Number of Dynamic Patched-Grid Interfaces 

ninter2 - dynamic patched-grid flag (zonal interface along a common interface, 

with grids in relative motion on either side of the interface) 

If Then 

ninter2 = 0 no patched-grid data is needed (no patched interfaces) 
ninter2 > 0 patched-grid data calculated at every time step 
Notes 

(1) This type of patched-grid data cannot be read in from a file since it 
must be recalculated for every time step. If there are interfaces for 
which static patch data is required, use the standard patch input 
method (precalculate with ronnie and set ninter < 0 in “LT27 - Num- 
ber of Patched-Grid Interfaces” on page 38). 

(2) Any block segments that are dynamically patched must also be input 
in the boundary condition section (“LT13 - Boundary Condition Seg- 
ments” on page 31 through “LT19 - KDIM Boundary Condition 
Specification” on page 35), using bctype = 0. 

(3) Further information on patching can be found in the input . doc file 
for the ronnie preprocessor. It is recommended that some experience 
be gained with static patching (via ronnie) before attempting dynamic 
patching with moving zones. 

(4) While most of the input for static and dynamic patching is the same, 
dynamic patching requires a few extra pieces of information, 
described below. 


3.42 LT42 - Dynamic Patched-Grid Specifications 


(Data for Line Type Forty-Two should be repeated ninter2 times.) 


int 

ifit 


limit 


itmax 


- interpolation number 


- type of fit 

If 

ifit = 1 
ifit = 2 
ifit = 3 

ifit = 4 


Then 

bi-linear fit 

serendipity (degenerate) bi-quadratic fit 
quadratic fit in \ ; linear fit in T| 
linear fit in ^ ; quadratic fit in T| 


- maximum step size (number of cells) to use in the search routine (limit = 
1 recommended) 

- maximum number of iterations allowed to find each “to” cell (itmax = 
maximum grid dimension recommended) 
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mcxie - flag to indicate whether the i; = 0 boundaries on either side of the patch 

interface are to be rendered coincident (generally required if ^ = 0 cor- 
responds to a viscous surface) 

If Then 

mcxie = 0 do not render the ^ = 0 boundaries coincident 

mcxie >100 render the % = 0 boundaries coincident 

mcxie = 1 to 100 The code will try to decide whether or not the bound- 
aries should be rendered coincident. The larger the 
value, the greater the number differences between the 
two boundaries can be before deciding they should not 
be rendered coincident. 

Note 

(1) For multiple “from” blocks, in which multiple T) coordinate sys- 
tems are defined, the proper Z, = 0 boundary to consider is the one 
closest to the \ = 0 boundary on the “to” side. 

mceta - flag to indicate whether the r| =0 boundaries on either side of the patch 

interface are to be rendered coincident (generally required if T) = 0 cor- 
responds to a viscous surface) 

icO -flag for C-0 continuous boundaries (not applicable to dynamically 

patched interfaces; set icO = 0) 

iorph - flag to allow points which cannot be located by the search routine to be 

tagged as “orphan” points and to be marked as being “interpolated” from 
block 0 

If Then 

iorph = 0 do not allow orphan points 

iorph = 1 allow orphan points (not recommended for dynamic patch 
interfaces at this time) 

itoss - flag to allow faster patching for cases in which the interface lies along a 

constant (or very nearly so) coordinate surface 


!£ 

Then 

itoss - 0 

interface is non-planar 

itoss = 1 

interface is an x = constant plane 

itoss = 2 

interface is an y = constant plane 

itoss = 3 

interface is an z = constant plane 

Notes 



(1) While itoss = 0 can always be used, it will slow down the dynamic 
patching considerably. Thus, if the interface is on a constant coordi- 
nate surface, the appropriate value of itoss is strongly recommended. 

(2) All of the above parameters except itoss are also used as input to ron- 
nie. 


it n 
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3.43 LT43 - Dynamic Patching “To" Grid Specifications 

(Data for Line Type Forty-Three should be repeated ninter2 times.) 

int - interpolation number 

to - a three or four digit number indicating the block number and face of the 

“to” surface (“to” refers to the block being interpolated) 
to = Nmn 

where 

N is the block number (N may be up to two digits) 

m is the coordinate direction; 1 = i, 2 = /, 3 = it 

n is the minimum or maximum face; 1 - minimum, 2 - maximum 

xiel - starting index in £ for which interpolation coefficients will be found on 

the “to” side of the interface 

xie2 - ending index in £ for which interpolation coefficients will be found on 

the “to” side of the interface 

etal - starting index in T| for which interpolation coefficients will be found on 

the “to” side of the interface 

eta2 - ending index in T| for which interpolation coefficients will be found on 

the “to” side of the interface 

nfb - number of block boundaries which make up the “from” side of the patch 

surface (“from” refers to the block(s) from which the interpolations are 
made) 

Notes 

(1) If the entire range is desired, a shortcut is to set xiel = xie2 = etal = 
eta2 = 0. 

(2) Important : For dynamic patching, additional “ghost” block bound- 
aries are often required. The baseline value of nfb is set from the 
zonal setup at t = 0 (as in static patching). However, as soon as the 
zones start to move past one another, portions of some block faces 
may not have an opposing block to interpolate from. To provide the 
patching algorithm with a block to interpolate from, one or more of 
the “from” blocks that match to the “to” side at t = 0 are duplicated 
and then translated or rotated by an appropriate amount to provide 
coverage of the “to” side as the zones move past one another. The 
baseline value of ntb must then be increased accordingly. 


3.44 LT44 - Dynamic Patching “From ” Grid Specifications 

(Data for Line Type Forty-Four should be repeated nfb times for each Line Type Forty-Three.) 


CFL3D User’s Manual 51 



CHAPTER 3 Input Parameters 


from - a three or four digit number indicating the block number and face of the 

“from” surface (“from” refers to the block(r) from which the interpola- 
tions are made) 
from = Nmn 

where 

N is the block number (N may be up to two digits) 

m is the coordinate direction; \ = i ,2 = j ,3 = k 

n is the minimum or maximum face; 1 = minimum, 2 = maximum 


xiel 

- starting index in £ for which interpolation coefficients will be found on 
“from” side of interface 

xie2 

- ending index in E, for which interpolation coefficients will be found on 
“from” side of interface 

etal 

- starting index in T| for which interpolation coefficients will be found on 
“from” side of interface 

eta2 

- ending index in T| for which interpolation coefficients will be found on 
“from” side of interface 

factj 

- expansion factor in the £, direction (not implemented at this time (set 
factj = 0)) 

factk 

- expansion factor in the T| direction (not implemented at this time (set 
factk = 0)) 


Note 

(1) If the entire range is desired, a shortcut is to input zeros for the begin- 
ning and ending indices. 


3.45 LT45 - Displacement and Rotation Amounts 

(Data for Line Type Forty-Five should be repeated nfb times for each Line Type Forty-Three.) 

dx - amount (in grid units) to displace the “from” block in the x direction 

dy - amount (in grid units) to displace the “from” block in the y direction 

dz - amount (in grid units) to displace the “from” block in the z direction 

dthetx — amount (in degrees) to rotate the “from” block in the x direction 

dthety — amount (in degrees) to rotate the “from” block in the y direction 

dthetz — amount (in degrees) to rotate the “from” block in the z direction 
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Nondimensionalization 



The goal of many CFD problems is to solve the flow over configurations that have 
been tested in wind tunnels or flight tests. In experimental tests, the model being studied is 
of known dimensions. Since there is no standard system of measurement for such testing, 
some models are measured in feet, some in meters, some in inches, etc. Similarly, wind 
speeds might be measured in feet/second or meters/second or some other way. Nondimen- 
sionalizing the flow-field parameters in a CFD code removes the necessity of converting 
from one system to another within the code. 

Throughout this chapter, the term free stream is used. Please see the note on page 3 
concerning its usage. 


4.1 Dimensional Parameter Definitions 

The following parameters are used to nondimensionalize the flow-field variables: 

L = characteristic length, feet (e.g. chord) 

L re j = corresponding length in the grid (nondimensional) 

Lfl = L/ L re j- = reference length used by code, feet (dimensional) 

= free-stream density, slug/feet 3 
a ^ = free-stream speed of sound, feet/second 

|V|. = free-stream velocity, feet/second 

= free-stream molecular viscosity, slug/feet-second 
7 = time, seconds 


CFL3D User’s Manual 53 






CHAPTER 4 Nondimenslonalization 


The ~ here and elsewhere indicates a dimensional quantity. Note that meters or inches, 
etc. could be substituted for feet in the above definitions, as long as it is done consistently. 


4.2 General Flow-Field Variables 

In CFL3D, the nondimensionalizations are performed as follows: 


Also, 


p = 

Poo 


Poo = 1 


u 

u = •=— 
a„ 


u - M cosacosB 

OO OO » 


= -A/^sinP 


w 

w = — 


sin a cos P 


poo(^oo) 


P°° y 


PooCO 


1 ( CAfoo) 

Y(Y - 1) + 2 


a 

a = — 
a 


a = 1 


~ T yp 2 
T ----- a 

L P 


T = 1 


x v _ y_ 

X = — > 7 

L r Lr 

z _ i_ ^oo 

Lr Lr 


Also, Reynolds number based on the characteristic length is 
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4.3 Reynolds Number Examples 

Experience has shown that some confusion arises when it comes to setting the parame- 
ter reue in CFL3D. Some examples may help. 

Suppose the configuration to be analyzed has a body length of 48 inches and it is 
desired to run a simulation in which the Reynolds number based on the body length is 

6xl0 6 .Thus, L = 48 inches and /?e- = 6xl0 6 . 
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To carry out the simulation, a grid is required. Suppose three people each create a grid. 
In the first person’s grid, the length of the body is 48, i.e. the configuration is full size in 
the grid coordinate system. Thus, L ref in grid 1 is 48. Therefore, by Equation (4-5), 


reue = ^i^-XlO -6 = 0.125 
48 


The second person decides to normalize the grid such that the body has a length of 1 . 
Thus, L ref in grid 2 is 1 and by Equation (4-5), 

reue = xlO = 6.0 (4-io) 

The third person was given the geometry definition in centimeters. Grid 3 is therefore 
generated with a body length of 121.9 (48 inches = 121.9 centimeters), so L re j- = 121.9 


reue = ^1®-Xl0 6 = 0.04922 
121.9 


4.4 Time and Time Step 

Time is nondimensionalized as follows: 


ta„ 

t = ^ (4-12) 

Lr 

If a particular dimensional time step (dt in “LT5 - Time Step Parameters” on page 21) is 
required, then this relation may be used to determine the corresponding input value of At . 

For the time step, 

At = desired time step, seconds 
Therefore, 


At = 
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4.5 Moving Mesh 

These additional values may be needed for the nondimensionalization of the moving- 
mesh parameters: 

/ = frequency, cycles/second 

k r = reduced frequency, k r = fL/a x Note: This definition of reduced frequency dif- 
fers from the “standard” definition k r = fL/\\\„. Also, note that the quantities 
L and L ref used to nondimensionalize the moving mesh data need not be the 
same as those used to nondimensionalize x, y, z, and t. That is why L re j is 
input explicitly in the moving mesh section of the input file. 

k g = L/ (2na oo 7 0 ) = rate of growth of displacement, where t 0 = the time to reach 
63.2% of the maximum displacement, seconds 


4.5. 1 Translational Motion 

These dimensional parameters are also needed for the translational nondimensional- 
izations: 

u, rans = x component of translational velocity, feet/second (needed for itrans =1) 

v trans = y component of translational velocity, feet/second (needed for itrans = 1 ) 

w [rans = z com pc> n ent of translational velocity, feet/second (needed for itrans =1) 

x max = maximum x displacement, feet (needed for itrans >1) 

y ma x ~ maximum y displacement, feet (needed for itrans >1) 

z max = maximum z displacement, feet (needed for itrans >1) 

Again note that meters or inches, etc. could be substituted for feet in the above definitions, 
as long as it is done consistently. Also, not all of the above dimensional parameters are rel- 
evant to a given problem. For example, in sinusoidal plunging (itrans = 2), k g , u trans , 

v trans ’ and ™ irons are irrelevant. 
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4.5. 1.1 Translation With Constant Velocity 

For itrans = 1 , input the following nondimensional parameters: 
rfreq = 0.0 

utrans = « frflnj /5 00 (Mach number of x translation) 


vtrans = v trm /a„ 


wtrans = w trttns /a„ 


The nondimensional displacement in the code is then governed by 


x = U ,rans t 


y = v ,rans t 
z = Wtrans 1 


(4-14) 


4.5. 1.2 Sinusoidal Plunging 

For itrans = 2, input the following nondimensional parameters: 

rfreq = k r 

utrans = x max /L R 
vtrans = y max /L R 
wtrans = z max /L R 

Note that, x max /L R , for example, is simply the maximum x displacement in “grid units”. 
The nondimensional displacement in the code is then governed by 


58 CFL3D User’s Manual 


4.5.1 Translational Motion 



wtrans = z max /L R 

Note that, x max /L R , for example, is simply the maximum x displacement in “grid units”. 
The nondimensional displacement in the code is then governed by 
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r- 

( kt Vi 

X — 11 
A “trans 

1.0 - exp 



- 

y WefZ j 


- 

( kJ Yl 

y ~ V trans 

1 .0 - exp 

C 2K L ) 


i- 

y L ref'l 


p 

( k t Vi 

Z = w trans 

1 .0 - exp 

{- 2n L ) 


- 

V L-ref ' J 


Thus, with utrans = x max , x will attain 63.2% of it’s maximum value, i.e. 


at a nondimensional time of 


, _ L ref 

0 2 nk r 


rfreq for itrans = 3 may therefore be defined as 


rfreq = — — = 


2nt 0 27ta„f| 


o 


(4-18) 


(4-19) 


(4-20) 


(4-21) 


where 1 0 is the time (seconds) to reach 63.2% of the maximum displacement. Increasing 
rfreq has the effect of decreasing the time to attain a specified percentage of the asymp- 
totic maximum displacement. 

4.5.2 Rotational Motion 

These additional dimensional parameters are needed for the rotational nondimension- 
alizations: 

= jc component of rotational velocity, revolutions/second (needed for irotat = 1) 
t b y = y component of rotational velocity, revolutions/second (needed for irotat = 1 ) 
(d z = z component of rotational velocity, revolutions/second (needed for irotat = 1 ) 

0 t max = maximum angular displacement about x axis, degrees (needed for irotat >1) 


i m 
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0>’, max = maximum angular displacement about y axis, degrees (needed for irotat >1) 

®z,max = maximum angular displacement about z axis, degrees (needed for irotat >1) 

Again note that meters or inches, etc. could be substituted for feet in the above defini- 
tions, as long as it is done consistently. Not all of the above dimensional parameters are 
relevant to a given problem. For example, in sinusoidal pitching (irotat = 2) k g , (h x , (Q y , 

and (£> z are irrelevant. 

Using these dimensional values, the nondimensionalizations are performed as follows: 


4.5.2. 1 Rotation With Constant Angular Velocity 

For irotat = 1, input the following nondimensional parameters: 

rfreq = 0. 

omegax = u> x L/a m 


omegay = (b^L/a^ 


omegaz = taX/a^ 


For turbomachinery type applications, L is typically chosen as the prop/blade diameter, so 
that cb^ , (by , c bj = M „ / (advance ratio). The angular displacement (radians) in the code 
is then governed by 


6 

6 

0 


X 


y 


z 


2n 

2n 

2k 


°v 


L 'ref 

« V 

L ref 


MX 


"ref 


4. 5.2.2 Sinusoidal Variation of Angular Displacement 
For irotat = 2, input the following parameters: 


(4-22) 
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rfreq = k r 


omegax = 0 A - max , degrees 


omegay = 0^ max , degrees 


omegaz = 0,, max , degrees 

The rotational displacement (radians) in the code is then governed by 


“ <B >Tio sin ( 2rc *^ 

e » = 


If the time step is to be chosen so that there are N steps per cycle, the required input value 
of dt (see “LT5 - Time Step Parameters” on page 21) may be determined from 

L re f 

At = (4-24) 

k r N 

The corresponding dimensional time step is: 

At = -U (4-25) 

Nf 

4. 5.2. 3 Acceleration to a Constant Rotational Displacement 

For irotat = 3, input the following nondimensional parameters: 

rfreq = k g 

omegax = Q x>max , degrees 
omegay = Q y , max , degrees 
omegaz = max , degrees 
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The rotational displacement (radians) in the code is then governed by 



Thus, with to^. = 0 jc , max , Qj. will attain 63.2% of it’s maximum value, i.e. 



(4-26) 


(4-27) 


(4-28) 


Increasing k r has the effect of decreasing the time to attain a specified percentage of the 
asymptotic maximum displacement, rfreq for irotat = 3 may therefore be defined as 


rfreq = — — = — — _ 

2nt 0 Ina^tQ 


(4-29) 


where t Q is the time (seconds) to reach 63.2% of maximum displacement. 
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File Formats 



This chapter describes the input and output files listed in Section 3.1. Typical names 
are given below; however, these names can be changed by the user to pertain to certain 
cases. 

I/O FILES 
grid . bin 
plot 3dg . bin 
piot3dq.bin 
cf 13d. out 
cf 13d . res 
cf 1 3d . turres 
cf 1 3d . blomax 
cf 13d. out 15 
cf 13d . prout 
cf 13d . out20 
ovrlp . bin 
patch . bin 
restart . bin 


5.1 Input Files 

There are two input files that must be available to CFL3D whenever a case is submit- 
ted. These files are the grid file (unit 1) and the input file (unit 5) defining the case. The lat- 
ter file is described in detail in Chapter 3. A restart file (unit 2) must be available for a 
restart case; however, for a start from “scratch”, it is not needed. In addition, there are two 
files that may be needed at submission depending on the problem being solved. When 
overlapped grids are used, the interpolation and boundary data file (unit 21) must be avail- 
able. When patching is utilized, the patched boundary data file (unit 22) must be available. 

5.1.1 Grid File 

grid.bin (unit 1) 

The grid must be generated using grid-generation software (CFL3D does not generate 
grids). Take care when generating a grid. Grid spacings should vary smoothly; the grid 
should “look nice”. (See the troubleshooting notes about grids in Chapter 10). Unless 
there is a good reason for not doing so, the grids, as well as all segments, should be multi- 
gridable (see Section 7.1.2 on page 127). Grid stretching should not be too severe if it can 
be avoided since it can degrade the accuracy and convergence of the code. 
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The grid file is in binary format. In the input file, the parameter ngrid is set as the total 
number of grids to be read in by CFL3D. The sign of ngrid indicates whether the grid will 
be read in CFL3D format or in PLOT3D format. (Note that TLNS3D 42 uses PLOT3D for- 
mat.) CFL3D-type grids always have alpha measured in the x-z plane, with z as the 
“up” direction (i.e. alpha = 90° would give a free-stream velocity vector in the positive z 
direction). PLOT3D-type grids may be utilized with either z being “up” (alpha measured 
in the x - z plane) or y being “up” (alpha measured in the x - y plane) depending on the 
value of ialph (see “LT3 - Flow Conditions” on page 19). See Appendix I for an illustrated 
definition of a. When PLOT3D-type grids are input, they are immediately converted 
internal to the code to CFL3D format. Thus the actual computations are always carried out 
internally as if z is “up”. 

If ngrid > 0, the following CFL3D grid format is used to read in the grid(s): 

do 10 n=l, ngrid 

read ( 1 ) jdim (n) , kdim (n) , idim (n) 

read ( 1 ) ( ( (x (i , j , k, n) , j = l , jdim(n) ) , k=l,kdim(n) ) ,i = l, idim(n) ) , 

( ( (y(i, j,k,n) , j=l, jdim(n) ) ,k=l,kdim(n) ) , i = l , idim(n) ) , 

( ( ( z ( i , j , k , n) , j=l, jdim(n) ) ,k=l,kdim(n) ) , i=l , idim (n) ) 

10 continue 

If ngrid < 0, the following PLOT3D grid format is used to read in the grid(s): 

read(l) ngrid 

read ( 1 ) (idim(n) , jdim(n) ,kdim(n) ,n=l, ngrid) 

do 20 n=l, ngrid 

read (1) ( ( (x { i , j , k, n) , i=l , idim(n) ) , j =1 , jdim(n) ) , k=l,kdim(n) ) , 

( ( (y (i, j ,k,n) , i = l, idim(n) ) , j=l, jdim(n) ) ,k=l,kdim(n) ) , 

( ( (z ( i , j , k, n) , i = l , idim (n) ) , j =1, jdim(n) ) , k=l , kdim(n) ) 

20 continue 

It does not matter which grid format is used. What does matter is the particular orien- 
tation of i,y, and k relative to the body and flow field, since the matrix inversions are 
done in a particular order. Experience has indicated that it is usually best (from speed of 
convergence perspective) to have the k direction be the primary viscous direction (i.e., the 
primary direction of the grid lines normal to the body). If bodies exist with more than one 
grid line orientation, then choose one of them to serve as the indicator of the “primary” 
viscous direction. Also, it is usually best if the j direction is taken as the streamwise direc- 
tion and the i direction as the spanwise direction. Hence, for an existing grid with i is in 
the streamwise direction, j in the normal direction, and k in the spanwise direction, it 
might be a good idea to first swap the indices: i — > j , j — > k , and k > i , to put them in 
CFL3D"s “preferred” orientation before running. The new grid created can be either 
CFL3D-type or PLOT3D-type. Finally, note that it is not always necessary to follow this 
guideline; performance is case dependent. Just be sure to satisfy the right-hand rule at all 
times, as discussed in the next section. 

For 2-D grids (i2d=l), idim must be 2 (i.e., the grid must be described by 2 repeated 
planes). We recommend making the grid-distance between the planes = 1, although any 
distance is okay provided that it is accounted for in the sref term in the input file. 
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5.1.2 The Right-Hand Rule 

The right-hand rule must be obeyed by the grid coordinates ( x , y, z) and the grid indi- 
ces (/, j, k ). Error messages and an immediate halt to execution will result if it is not. As a 
reminder of this important rule, consider the system of axes in Figure 5-1. Imagine point- 
ing the right-hand index finger along the positive x axis. Then curl the rest of the right- 
hand fingers toward the positive y axis. The thumb, pointing straight out, is now in the 
positive z direction. 


z 



Figure 5-1. Three-dimensional system of axes showing positive x, y , and z directions. 



Figure 5-2. Index direction examples. 


Keep in mind that the same rule applies to the indices i, j, k . Suppose the positive i, j , 
and k directions run along the positive x, y , and z axes, respectively, as drawn in 
Figure 5-1. This is the simplest case and is illustrated in Figure 5-2(a). Suppose it is neces- 
sary, however, for the positive i index direction to run in the opposite direction of positive 
x as drawn in Figure 5-2(b). (This means, for example, that if x varies from 0.0 to 1 .0 and 
idim = 5, then at i = 1, x = 1.0 and at i = 5, x = 0.0.) One of the other index directions 
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must also be changed to maintain the right-hand rule. In Figure 5-2(b), the j index direc- 
tion has been changed. 

Also, i, j , and k do not have to be in the x, y , and z directions, respectively. Any per- 
mutation is valid as long as the right-hand rule is upheld. (However, keep in mind the dis- 
cussion above in Section 5.1.1 as well as Note (6) describing the ivisc(m) input on page 27 
when setting the index directions.) 

5.1.3 Restart File 


restart.bin (unit 2) 

The restart file is in binary format. It must be available at the beginning of the program 
execution for a restart of a previous solution (irest > 0). The restart file is overwritten dur- 
ing program execution; therefore, before resubmitting the case, be sure to save any restart 
files that may be needed later ! The binary restart file has the following format. (Note that 
this Version 5.0 format is different from the formats in Version 4.1 and earlier versions.) 

General case information, the q array, and the turbulence quantities are written as fol- 
lows (nbik is the total number of blocks): 

do nb=l,nblk 

write ( 3 ) t itlw, xmachw, jdim,kdim, idim, alphw, reuew, ntr , time 
c 

if (nb.eq.l) then 

write (3) (rms(n), n=l,ntr), 

(cdw(n) , n=l , ntr) , 

(cdvw(n), n=l,ntr), 

(cyw(n) , n=l , ntr) , 

(cmxw(n), n=l # ntr), 

(cmzw(n), n=l,ntr), 

(cftmomw(n), n=l,ntr), 

(cftvw(n), n=l,ntr), 

end i f 
c 

write (3) ( ( ( (q ( j , k, i , 1 , nb) , j=l, jdim-1) ,k=l, kdim-1) , 

i=l , idim-1 ) , 1=1 , 5 ) 

c 

write (3) ivl,iv2,iv3 

if (nb.eq.l) then 

write ( 3 ) (rmstrl (n) , n=l , ntr ) , ( rmstr2 (n) , n=l , ntr) , 

(nnegl(n), n=l , ntr ) , (nneg2 (n) , n=l,ntr) 

end if 
c 

if (ivl.ge.2 .or. iv2.ge.2 .or. iv3.ge.2) then 

write (3) ( ( (vist3d ( j , k, i , nb) , j=l, jdim-1) ,k=l, kdim-1) , i = l, idim-1) 

end i f 

if (ivl.ge.4 .or. iv2.ge.4 .or. iv3.ge.4) then 

write (3) ( ( ( ( tursav ( j , k , i , m, nb) , j=l, jdim-1) , k=l , kdim-1) , 

i = l, idim-1) ,m=l,2) 

write ( 3 ) ( ( ( smin ( j , k , i , nb ) , j =1 , j dim- 1 ) , k=l , kdim- 1 ) ,1 = 1/ idim- 1 ) 
if (ivl.eq.4 .or. iv2.eq.4 .or. iv3.eq.4) then 
write (3) ( ( (xjb ( j , k, i , nb) , j=l, jdim-1) ,k=l, kdim-1) , i = l, idim-1) 
write ( 3 ) ( ( (xkb ( j , k , i , nb) , j =1 , j dim- 1 ) , k=l , kdim- 1) , i = l, idim-1) 
write ( 3 ) ( ( (blnum ( j , k, i , nb) 0 = 1, jdim-1 ) , k=l , kdim-1 ) , i = l , idim-1) 



(clw(n) , 
(cdpw(n) , 
(cxw(n) , 
(czw(n) / 

( cmyw ( n ) , 

( fmdotw (n) , 
(cf tpw(n) , 

( cf ttotw (n) 


n=l , ntr) , 
n=l , ntr) , 
n=l , ntr) , 
n=l , ntr) , 
n=l , ntr) , 
n=l , ntr) , 
n=l / ntr) , 
, n=l,ntr) 
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c 


c 


end i f 

if (ivl.eq.9 .or. iv2.eq.9 .or. iv3.eq.9 .or. 
ivl .eq. 13 .or . iv2 . eq . 13 . or . iv3.eq.13) then 
■ write (3 ) ( ( (cmuv ( j f k, i , nb) , j =1 , jdim-1) , k=l , kdim-1 ) , i = l , idim-1) 

end i f 
end i f 
end do 


if (dt.gt.O) then 
write (3) iflagg 

if (iflagg. eq.l .or. iflagg. eq. 3) then 
do nb=l,nblk 

write(3) jdim, kdim, idim 

write (3) ( ( ( (qcO ( j , k, i , 1 , nb) , j=l, jdim-1) , k=l, kdim-1) , 

i=l , idim-1 ) ,1=1,5) 

end do 
end if 


if (iflagg. eq. 2 .or. 
do nb=l,nblk 

write (3) iunst 
if (iunst .ne. 0 
write ( 3 ) 
wr i t e ( 3 ) 


iflagg .eq.3) then 


end 
end do 
end i f 
end i f 


if 


then 
jdim # kdim, idim 

itrans , rf reqt , xorig , yorig , zorig, xorigO , yorigO , 
zorigO , utrans , vtrans , wtrans , dxmx, dymx , dzmx, 
itransmc , rf reqtmc , xor i gmc , y or i gmc , zorigmc, 
xorigOmc # yorigOmc , zorigOmc , utransmc , vtransmc, 
wtransmc , xmc , ymc , zmc , dxmxmc , dymxmc , dzmxmc , 
i rot at , rf reqr , the tax, the t ay , theta z , 
omegax, omegay , omegaz , dthxmx, dthymx, dthzmx, 
irotatmc r r f reqrmc , thetaxmc , thetaymc , thetazmc , 
omegaxmc , omegaymc , omega zmc , dthxmxmc , dthymxmc , 
dthzmxmc, time 2 , t ime2mc , dt 


Where 

Indicates 

ti tlw 

a real array of length 20 describing the case 

xmachw 

Mach number 

jdim, kdim, idim 

grid dimensions 

alphw 

angle of attack 

reuew 

Reynolds number 

ntr 

number of iterations 

time 

time (for time-accurate computations) 

rms 

residual 

clw 

lift coefficient 

cdw 

drag coefficient 

cyw 

force coefficient in y direction 

cmyw 

moment coefficient about y 

cdpw 

pressure drag coefficient 

cdvw 

viscous drag coefficient 

cxw 

force coefficient in x direction 

czw 

force coefficient in z direction 

cmxw 

moment coefficient about x 
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cmzw 

fmdotw 
c f tmomw 
cf tpw 
cf tvw 
cf ttotw 

q 

ivl,iv2,iv3 

rmstrl 

rmstr2 

nnegl 

nneg2 

vist3d 

tursav 


smin 
x jb 

xkb 

blnum 

cmuv 

qcO 

i f lagg 


moment coefficient about z 
mass flow through control surface 

magnitude of resultant momentum force on control surface 
magnitude of resultant pressure force on control surface 
magnitude of resultant viscous force on control surface 
magnitude of resultant (pressure + momentum + viscous) force on 
control surface 

nondimensional primitive variables; q = [p , u,v,w, p] 
ivisc(l), ivisc(2), and ivisc(3) 

residual for first turbulence model equation (if used) 

residual for second turbulence model equation (if used) 

number of points at which first turbulence model variable needed to be 

limited 

number of points at which second turbulence model variable needed to 
be limited 

nondimensional turbulent eddy viscosity \l T 

nondimensional turbulence quantities for field-equation turbulence 
models (varies with model); tursav(2) is also used to store nearest 
wall i location for the Baldwin-Barth turbulence model 
minimum distance function for field-equation turbulence models 
nearest wall j location for Baldwin-Barth turbulence model 
nearest wall k location for Baldwin-Barth turbulence model 
nearest wall block number for Baldwin-Barth turbulence model 
variable C.. coefficient for Girimaji turbulence model 
Q values at previous time step 

parameter describing temporal order and whether grid is moving or 
stationary 

= 0 not second order, stationary grid 

= 1 second order, stationary grid 

= 2 not second order, moving grid 

= 3 second order, moving grid 


The dynamic grid parameters in the restart file are not described here. 


5.1.4 Grid-Overlapping and Patching Data Files 
ovrlp.bin (unit 21) 

The ovrlp.bin file is a binary file, which is only used for grid-overlapping cases. It is 
always listed at the top of the input deck. The file contains the interpolation stencils for 
overlapped grids and is created by running MaGGiE. 
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patch.bin (unit 22) 

The patch.bin file is a binary file, which is only used for grid-patching cases. It is 
also always listed at the top of the input deck. The file contains the interpolation stencils 
for patched grids and is created by running ronnie. 


5.2 Output Files 

CFL3D produces several output files. The following sections describe the contents and 
formats of these files. 


5.2.1 PLOT3D Files 


The PLOT3D files are binary files (or ascii, with the modification to the code as 
described in the footnote at the beginning of Chapter 3) which are input to flow visualiza- 
tion programs like PLOT3D or FAST. Partial or entire flow-field regions may be specified 
by the user in the input file. The parameter nplot3d specifies the number of regions to be 
written to the files and “LT28 - PLOT3D Output Specifications” on page 39 indicates the 
desired index ranges. Data may also be extracted from these files for post-processing pro- 
grams written by the user. In order to read these files for such a purpose, use the formats 
below. The number of grids to be read is indicated by nplots and id, jd, kd are the num- 
ber of points to be read on each grid. Note that these files can be specified as grid-point 
data files (iptype = 0) or cell-center data files (iptype = 1). 

plot3dg.bin (unit 3) 


For 3-d grids, 

write(3) nplots 

write(3) (id(n) , jd(n) ,kd(n) ,n=l, nplots) 

do n=l, nplots 

write (3 ) (((x(j,k,i,n),i=l,id(n)) , j =1 , jd (n) ) , k=l , kd (n) ) , 

( ( (y ( j r k, i # n) , i = l , id (n) ) , j =1 , jd (n) ) ,k=l, kd (n) ) , 

( ( (z ( j , k, i , n) , i = l , id (n) ) , j =1 , jd (n) ) ,k=l, kd (n) ) , 

( ( ( iblank (j,k,i,n) , i=l , id (n) ) ,j=l,jd(n) ) , k=l , kd (n) ) 

end do 

For 2-d grids, 

write ( 3 ) nplots 

write ( 3 ) ( jd (n) # kd (n) , n=l , nplots ) 

do n=l,nplots 

write { 3 ) ( (x ( j , k, n) , j =1 , jd (n) ) , k=l , kd (n) ) , 

((z(j,k,n),j=l,jd(n)) , k=l, kd(n) ) , 

( ( iblank (j , k, n) , j = 1 , jd (n) ) , k=l , kd (n) ) 

end do 
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plot3dq.bin (unit 4) 

The flow-field data file has the following formats. For 3-d grids, 

write ( 4 ) nplots 

write (4) (id(n) , jd<n) ,kd(n) ,n=l, nplots) 
do n=l, nplots 

write (4) xmach, alpha , reue , time 

write { 4 ) ( { ( (q(j , k, i ,m, n) , i = l , id(n) ) , j=l , jd (n) ) , k=l , kd (n) ) , m=l, 5) 

end do 


For 2-d flow-field data files, 

write(4) nplots 

write ( 4 ) ( jd (n) # kd (n) , n=l , nplots) 
do n=l, nplots 

write ( 4 ) xmach # alpha , reue , time 

write (4 ) ({(q(j,k,m,n),j=l # jd(n)) , k=l , kd (n) ) , m=l , 4 ) 

end do 

Note that five flow-field variables are output for 3-d grids, whereas four variables are out- 
put for 2-d grids. Also, note that q here is the array of conserved variables Q. 

When using iptype = 0, be aware that the solution on block edges and comers may be 
inaccurate. This is because CFL3D solves for cell-center values. Values at grid points must 
be reconstructed from cell-center data and the reconstruction process at edges/comers is 
not unique. 

When iptype = 2, CFL3D outputs turbulence quantity information rather than the con- 
served variables Q. See the note in Section 3.28 on page 39. 

When iptype > 2, a PLOT3D function file is output in place of the Q file. The function 
file format for 3-d grids is 

write (4) nplots 

write (4) ( id (n) ,jd(n) ,kd(n) , 1 ,n=l , nplots) 
do n=l, nplots 

write (4) ( ( ( f ( j , k, i , n) , i=l , id (n) ) , j =1 , jd (n) ) , k=l,kd(n) ) 

end do 

For 2-d function files, 

write (4) nplots 

write (4 ) (jd(n),kd(n),l,n=l, nplots) 
do n=l, nplots 

write (4) ((f(j,k,n),j=l,jd(n)),k=l,kd(n)) 

end do 

Note that function files are currently written for a single function only. See Section 3.28 on 
page 39 for information on what functions are currently available. 
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5.2.2 Ascii Format Files 

cfl3d.out (unit 1 1) 

The cf 13d. out file is the primary output file. It echoes the input file with the appro- 
priate bookkeeping changes, such as updates in block numbers when coarser grids are 
generated internally. The file then gives a “blow-by-blow” message about what steps have 
been performed: the grid is read in, the metrics are computed, etc. until finally the other 
output files are written. Another important function of this file is to print any warnings and 
error messages. For example, it will reveal any mismatches in one-to-one block connec- 
tions, signaling a problem with the grid or input file. It is a good idea to run a new job for 
a few iterations only and then to study this file to make sure everything looks as expected. 

cfI3d.res (unit 12) 

When ihstry = 0, the cfl3d.res file contains the residual, lift, drag, side force, and 
moment histories. When ihstry > 0, the residual, mass flow, pressure force, viscous force, 
and momentum force are given instead. This type of file has been used for all of the “iter- 
ation history” plots presented in this manual. The following sample format shows a por- 
tion of the cf 13d. res file (when ihstry = 0) for the flat plate test case discussed in 
Section 9.1.5 on page 173. When sub-iterations are used in a time-accurate computation, 
only the final residuals and forces from the last sub-iteration of each time step are output 
to unit 12. (For the sub-iteration residual history file, see page 76.) 

turbulent flat plate (plate from j=17-65, prior to 17 is symmetry) 

Mach= 0 . 2000E+00 , alphas O.OOOOE+OO, ReUe= 0.6000E+07 
Final res= 0.3623E-09 

Final c 1 , c d , cy , cmy = -0.1869E-02 0.2827E-02 0.0000E + 00 0.3174E-03 


800 it 
1 
2 

log ( res ) 

-0 . 15700E+02 
-0. 59009E+01 

cl 

0.25376E-12 

0.13542E-01 

cd 

0 . 67093E+00 
0. 40383E-01 

cy 

0 . 00000E+00 
0 . 00000E+00 

cmy 

-0.12688E-12 

-0.72299E-02 

799 

800 

-0 . 94402E+ 01 
-0 . 94409E+01 

-0 . 18662E- 02 
-0.18695E-02 

0.28275E-02 

0.28273E-02 

0 . 00000E + 00 
0. OOOOOE+OO 

0 . 31613E-03 
0 . 3 1742E-03 


Here, res is the L-2 norm of the residual for the equation for density. 

cfl3d.turres (unit 13) 

The cf 13d . turres file contains the residual history for the one or two-equation turbu- 
lence models (ivisc > 3). The sample below shows part of the cfl3d. turres file for the 
flat plate test case discussed in Section 9.1.5 on page 173.The log(turresl) quantity is 
the log of the residual for all one-equation models or the log of the residual for the co or e 
equation for two-equation models. Log (turres2) is the log of the residual for the k equa- 
tion for two-equation models and is not used for one-equation models. Nnegl and nneg2 
indicate how many field points require limiting (to avoid going negative) during that itera- 
tion. They should be zero or, at most, a small fraction of the total number of points for a 
converged solution. If they are large, they indicate a problem with convergence. (They 
may be large during start-up, as in this example, but should always go to zero or small val- 
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ues as the solution progresses.) When sub-iterations are used in a time-accurate computa 
tion, only the final residuals from the last sub-iteration of each time step are output. 

turbulent flat plate (plate from j=17-65. prior to 17 is symmetry) 

Mach= 0 . 2000E+ 00 , alpha= O.OOOOE+OO, ReUe= 0.6000E+07 
Final turresl= 0.5279E-09 
Final turres2= 0.5186E-09 


800 it 

log (turresl) 

log ( turres2 ) 

nnegl 

nneg2 

1 

-0 . 31193E+01 

-0 . 43162E+01 

0 

92 

2 

-0 . 34342E+01 

-0 . 53959E+01 

0 

2637 

799 

-0 . 92770E+01 

-0 . 92830E+01 

0 

0 

800 

-0 . 92774E+01 

-0 . 92852E+01 

0 

0 

cfl3d.blomax (unit 14) 




The c: 

f 13d . blomax file 

provides information 

about the Baldwin-Lomax turbulence 


model (ivisc = 2). 


cfl3d.outl5 (unit 15) 


The cf 13d . out 15 file is a secondary output file. It provides more in depth information 
about the progression of a case. It is primarily used by the programmer for debugging pur- 
poses. 


cfl3d.prout (unit 17) 


The Cf 13d .prout file contains the output as specified in the input file with the nprint 
parameter and “LT30 - Print Out Specifications” on page 41. Note that this file can be 
written for values at the grid points (iptype = 0) or cell-centers (iptype = 1). Keep in mind 
that this file can grow quite large rather quickly, so limit the regions specified for output. 
The cf 13d. prout file will also contain the control surface data if ncs > 0 (see 
Section 3.31 on page 42). (The sample below is from the flat plate test case discussed in 
Section 9.1.5 on page 173.) Note that dn, cf, ch, and ypius are only output when iptype = 
0. 


turbulent flat plate (plate from j=17-65, prior to 17 is symmetry) 
Mach alpha beta ReUe Tinf,dR time 

0.20000 0.00000 0.00000 0 . 600E+07 460.00000 0.00000 


BLOCK 1 


IDIM, JDIM, KDIM= 2 65 97 


I J K 
T/Tinf 

1 1 

0. 1 000E+01 
1 2 

0 . 1000E+01 


x y z U/Uinf V/Vinf W/Winf P/Pinf 

MACH cp tur. vis. 

1 -.3333E+00 0.0000E+00 0.0000E+00 0.9987E+00 O.OOOOE+OO -.7200E-07 
0 1000E+01 0.1997E+00 0.5992E-02 0.2054E-02 
1 - . 3125E+00 0.0000E+00 O.OOOOE+OO 0.9989E+00 O.OOOOE+OO 0.1323E-21 
0 . 1000E + 01 0 . 1998E + 00 0.6012E-02 0.1379E-02 


1 64 

0 . 9999E+00 
1 65 

0 . 9999E+00 


1 0.9792E+00 O.OOOOE+OO O.OOOOE+OO 0.0000E+00 
0 . 1008E+01 0.0000E+00 -.3123E-02 0.1966E-09 
1 0 . 1000E+01 O.OOOOE+OO O.OOOOE+OO 0 . 3675E-02 
0 . 1008E+01 0 . 7320E-03 -.3607E-02 0.1963E-09 


O.OOOOE+OO 0.0000E+00 
O.OOOOE+OO 0 . 5962E-08 
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I J K X Y Z an P/Pinf T/Tinf 

Cf Ch yplus 

1 2 1 - 0 . 3 12 50E+ 00 0.00000E+00 0.00000E+00 0.10000E-05 0.10002E+01 

0 . 1 0000E+01 0 . 00000E+00 O.OOOOOE+OO 0.00000E+00 

1 3 1 - 0 . 2 9167E+ 00 0.00000E+00 0.00000E+00 0.10000E-05 0.10002E+01 

0 . 1 0000E+01 0 . OOOOOE+OO O.OOOOOE+OO O.OOOOOE+OO 


1 63 1 0 . 95 833E+00 O.OOOOOE + OO O.OOOOOE + OO 0.10000E-05 0.99994E + 00 

0 . 1008 0E + 01 0 . 2 4677E-02 0.33657E-02 0.20858E + 00 

1 64 1 0 . 97 91 6E+00 O.OOOOOE+OO O.OOOOOE + OO 0.10000E-05 0.99991E+00 

0 . 1008 0E + 01 0 . 24 660E-02 0.24780E-02 0.20851E+00 


BLOCK 1 

IDIM, JDIM, KDIM= 

2 

65 97 




I J K 
T/Tinf 

X Y 

MACH cp 

Z 

tur . 

U/Uinf 

vis . 

V/Vinf 

W/Winf 

P/Pinf 


1 49 1 0.6667E+00 O.OOOOE+OO O.OOOOE+OO 0.0000E+00 O.OOOOE+OO 0.0000E+00 

0.1000E+01 0 . 1008E+01 O.OOOOE+OO 0.1029E-02 0.2188E-09 

1 49 2 0 . 6667E+00 O.OOOOE+OO 0.1000E-05 0.8330E-02 O.OOOOE+OO -.1105E-06 

0 . 1 OOOE+Ol 0 , 1008E+01 0.1659E-02 0.1029E-02 0.2112E-07 


1 49 96 0 . 6 667E+00 O.OOOOE+OO 0.9594E+00 0.9987E+00 O.OOOOE+OO 0.2794E-03 

0 . 1000E+01 0 . 1 OOOE+Ol 0.1997E+00 0.2587E-02 0.7274E-02 

1 49 97 0 . 6 667E + 00 O.OOOOE + OO 0.9837E+00 0.9987E + 00 O.OOOOE+OO 0.2672E-03 
0.1000E + 01 0.1000E+01 0 . 19 97E+00 0.2609E-02 0.7274E-02 

I J K X Y Z dn P/Pinf T/Tinf 

Cf Ch yplus 

1 49 1 0 . 66667E+ 00 O.OOOOOE+OO O.OOOOOE + OO 0.10000E-05 0.10000E+01 

0.10080E+01 0 . 2 5533E-02 0.16414E-02 0.21218E+00 

1 49 97 0 . 66667E+00 O.OOOOOE+OO 0.98367E+00 0.24255E-01 0.10001E+01 

0.10000E+01 0.234 5 5E- 13 0.60677E-09 0.15760E-01 


A sample of the type of control surface information that can be expected when ncs > 0 
is shown here (this is no longer for the flat plate test case): 

Control Surface 1 


Grid 1 (Block 1) i = 25, 25 j = 1, 33 k = 1, 25 iwall = 0 Normal = 1 

x-area = 0.2687E+02 y-area = 0.1842E+00 z-area = -0.1842E+00 total-area = 

0 . 2 687E + 02 

Mass averaged properties 

P/Pinf = 0.9446E+00 Pt/Pinf = 0.1022E+01 

T/Tinf = 0 . 9840E+00 Tt/Tinf = 0.1007E+01 

Mach number = 0.3367E+00 

Mass flow / ( rhoinf *vinf ) = 0.42300E+02 

x-force y-force z-force resultant- force lift-force 

drag- force 

Pressure force -0.52122E+02 -0.23196E+01 0.23205E+01 0.52226E+02 0.23205E+01 

-0. 52 122E+02 

Thrust force 0.12872E+03 0.23886E+02 -0.23848E+02 0.13307E+03 -0.23848E+02 

0 . 12 872E + 03 

Total force 0.76598E+02 0.21566E+02 -0.21527E+02 0.82437E+02 -0.21527E+02 

0 . 76598E+02 


This information is printed at the end of the cfi3d.prout file. 
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cf!3d.out20 (unit 20) 

The cf 13d . out2 o file is an auxiliary output file providing information when iunst > 0. 
It provides the unsteady pressures from forced oscillations. This file is primarily used by 
the programmer for debugging purposes. To output this file, hard- wire irite = lin sub- 
routine resp in rhs . f . 

cf!3d.subit_res (unit 23) 

The cf 13d . subit_res file is similar to the cfl3d.res file, except that it outputs 
residuals for all sub-iterations when time-accurate computations with sub-iterations are 
performed. This file is hard-wired with this name and is not in the file list at the top of the 

input file. However, whereas unit 12 outputs only R(q m ) for the equation for density (in 
Equation (B-12) or Equation (B-22) of Appendix B), unit 23 outputs the entire right-hand 
side of Equation (B-12) or Equation (B-22) for the equation for density. Therefore, the 
residuals in the two files do not match. 

cfl3d.subit_turres (unit 24) 

The cf 13d . subit_turres file is similar to the cfl3d.turres file, except that it out- 
puts field-equation turbulence model residuals for all sub-iterations when time-accurate 
cases with sub-iterations are run. This file is hard-wired with this name and is not in the 
file list at the top of the input file. 

cfl3d.dynamic_patch (unit 25) 

The cfl3d.dynamic_patch file is output when using the moving grid option with 
dynamic patching. This file is hard-wired with this name and is not in the file list at the top 
of the input file. 

5.2.3 PLOT3D Function Files 

If desired, CFL3D can output PLOT3D function files (for 3-d cases) with surface grid, 

y + , eddy viscosity, and normal spacing at the first grid point above all viscous walls. 
These files are: 

surf_xyz.fmt (unit 28) 

surf_y+.fmt (unit 29) 

surf_vist.fmt (unit 30) 

surf_dn.fmt (unit 31) 

For 2-d cases, a single file is output: 
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surf_y+_2d.fmt (unit 28) 

This file is in column format, containing all of the above information, with headers 
between different segments. By default, this option to write these files is currently turned 
off. To activate this option, the user must change ifunc from 0 to 1 in subroutine 

yplusout in Ibex . f . 
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The equations of motion require boundary conditions on all sides of the domain in 
which the solution is to be obtained, as well as on all surfaces of any objects which lie 
within the domain. For CFD methods, this implies that boundary conditions must be 
applied at each face of each computational block. Here, the term boundary conditions is 
used somewhat loosely as it refers to both physical conditions (e.g. solid wall, symmetry 
plane, etc.) and interfaces between adjacent or overlapped blocks. 

In CFL3D, the boundary condition data are located in the arrays qio(jdim,kdim,5,4), 
qj o(kdim,idim-l,5,4), and qkO(jdim,idim- 1,5,4) for the i, j, and k directions, respec- 
tively. The third index in the arrays indicates the position for the five flow-field primitive 
variables (Equation (E-3)). The fourth dimension indicates the storage location for the 
boundary value positions; indices 1 and 2 are the positions for the boundary data at the left 
face and indices 3 and 4 are the positions for the boundary data at the right face. “Left 
face” here refers to the i = 1, ; = 1, and k = 1 faces. “Right face” refers to the i = idim, 
j = jdim, and k = kdim faces. 

Note that the locations defining the boundary condition regions in “LT14 - 10 Bound- 
ary Condition Specification” through “LT19 - KDIM Boundary Condition Specification” 
are grid points, but the actual boundary conditions are applied at cell-face centers. 



i = 1 Segment 1 i = 5 


Figure 6-1. Boundary condition segments. 

For example, say that Figure 6-1 represents the surface of a wing. At the unshaded 
cells, it is desired to apply a heated wall boundary condition, while at the shaded cells it is 
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desired to apply an adiabatic wall boundary condition. One way to accomplish this objec- 
tive would be to divide the ko boundary condition into three segments, as indicated by the 
dashed lines in the figure. The CFL3D input file would look like this: 

Line Type 

18 KO: GRID SEGMENT BCTYPE ISTA I END JSTA JEND 

1 1 2004 1512 

twtype Cq 

1.6 0.0 

1 2 2004 1324 

twtype Cq 

1.6 0.0 

1 3 2004 3524 

twtype Cq 

0.0 0.0 

Note that, for example, the grid points i = 1 to 5, j = 1 to 2 define the boundary of the 
cells at which the boundary condition type for segment 1 is applied. 

Two types of boundary condition representations are employed in CFL3D, namely, 
cell-center and cell-face. For cell-center type boundary conditions, the flow-field variables 
are specified at “ghost” points corresponding to two cell-center locations analytically 
extended outside the grid as illustrated in Figure 6-2. For example, qi0(/\* JU) contains 
the boundary data at the ghost point locations right next to the / = 1 cell-center data and 
qi0(/,ifc,l,2) contains the boundary data in the second set of ghost point locations at the 
left boundary. Likewise, qi0(/\M,3) contains the boundary data at the ghost point loca- 
tions right next to the i = idim cell-center data and q i o(j ,k ,1,4) contains the boundary 
data in the second set of ghost point locations at the right boundary. The same boundary 
data location definitions apply for the qj o and qko arrays. 

For cell-face type boundary conditions, the flow-field variables and their gradients are 
specified at the cell-face boundary as illustrated in Figure 6-3. For cell-face type boundary 
conditions, qiO (J ,k ,1,1) contains the flow-field variable data at the i = 1 grid cell-face and 
qi0(y ,k ,1,2) contains the flow-field variable gradients at the i = 1 grid cell-face. Likewise, 
qi0(y ,k ,1,3) contains the flow-field variable data at the i =idim grid cell-face and 
q io(y " ,k ,1,4) contains the flow-field variable gradients at the i = idim grid cell-face. The 
same boundary data location definitions apply for the qj 0 and qko arrays. 

Note that when running in 2-d mode (i2d = 1), it does not matter what boundary con- 
ditions are used on the i = 1 and i = idim faces (provided that the boundary condition 
itself does not require more than one interior cell). Bctype is generally set to 1002 on 
these faces. 

Boundary conditions for the eddy viscosity are stored in vio, vjO, and vko, while 
boundary conditions for the field equation turbulence models are stored in tio, tjO, and 
tko. Both of these are cell-center type, although only the first ghost points (1 and 3) are 
used. The field equation turbulence model boundary conditions are described in more 
detail in Section H.7 on page 296. 


1 I!i 


NDATA 

2 

2 

2 
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# Cell-Center Points on Grid 


O Cell-Center Boundary Points 



2 1 3 4 


Figure 6-2. Cell-center type boundary locations. 



Cell-Center Points on Grid 
Cell-Face Boundary Points 
Gradients on Boundary Edge 



Figure 6-3. Cell-face type boundary conditions. 
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6.1 Physical Boundary Conditions 

The 1000 series of boundary condition types are used for physical boundary condi- 
tions and are specified at any of a block’s six faces in “LT14 - 10 Boundary Condition 
Specification” on page 32 through “LT19 - KDIM Boundary Condition Specification on 
page 35. In each case, ndata = 0, since no additional information is required for imple- 
mentation of the condition. The 1000 series boundary condition types currently supported 
are as follows: 


bctype. 

boundary condition 

1000 

free stream 

1001 

general symmetry plane 

1002 

extrapolation 

1003 

inflow/outflow 

1004 

(no longer available, use 2004 instead) 

1005 

inviscid surface 

1008 

tunnel inflow 

1011 

singular axis - half-plane symmetry 

1012 

singular axis - full plane 

1013 

singular axis - partial plane 

6.1.1 Free Stream 


bctype 1000 



The free stream boundary conditions are cell-center type boundary conditions. The 
five flow-field variables for both sets of ghost points are set equal to the initial values, 
which are: 

P initial = 

“initial = ACcOSttCOsP 

V initial = (6-1) 

w initial = AOinacosP 
Pinitial ~ P initial^ initial^ 


where a MtM =1.0. 


I 1 1 
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6.1.2 General Symmetry Plane 

bctype 1001 


• Cell-Center Points on Grid 


O Cell-Center Boundary Points 



Figure 6-4. Symmetry boundary conditions (bctype 1001) for density. 

The symmetry plane boundary conditions are cell-center type boundary conditions. As 
the name implies, symmetry is assumed across an axis. The ghost point density values are 
set equal to their “mirror image” counterparts. With the points defined as in Figure 6-4, 

P-i = Pi 

(6-2) 

P-2 - P2 

(Note that p ( = qio(j,k,l,l) at the i = 1 face, for example.) The pressure values are 
assigned in the same way. 

The velocity components at the ghost cells are obtained as follows. Consider ghost 
cells at an i = 1 face. Note that the normalized contravariant velocity U is normal to an 1 
= constant face. Let U j be the normalized contravariant velocity at cell center 1 in 

Figure 6-4. For an i symmetry plane, U must have opposite signs on each side of the 
plane. Thus 

u_i = «i - 2 4 * 1 /, 

V_J = Vj-2 % y U\ (6-3) 

= Wj -2% Z U\ 

where Z, x , ^ y , and are the metrics (unit normals) at the i = 1 face. 
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2 A 2 2 

Since (£*) + (| y ) + (| z ) = 1 , U_ { = U x . The velocity components at ghost cell 
center -2 are set in a similar manner using the data at cell center 2. (Note that this is now a 
“general” symmetry condition, applicable to any plane, not just the x — z plane as in ear- 
lier versions of the code. Consequently, there is no longer a bctype 1006.) 

6. 1.3 Extrapolation 

bctype 1002 

The extrapolation boundary conditions are cell-center type boundary conditions. The 
ghost points are extrapolated from the computational domain. Based on the locations of 
Pj, p j and p_ 2 depicted in Figure 6-4, the extrapolated values would be 

P-i = Pi 

( 6 - 4 ) 

P-2 = Pi 

The same zeroth order extrapolation is used for the boundary values of the other four flow- 
field variables. 

6.1.4 Inflow/Outflow 

bctype 1003 

The inflow/outflow boundary conditions are cell-face type boundary conditions. In the 
far field, the velocity normal to the far boundary (pointing out of the grid) and the speed of 
sound are obtained from two locally 1-d Riemann invariants: 


R = u± 


where the boundary is considered a surface of constant E, (in this example) with decreas- 
ing E, corresponding to the interior of the domain and 

l 

0 = 

v = iw“ + iv| v+ ivtr + iv?i "■ 7> 

R- can be evaluated locally from conditions outside the computational domain and R + can 
be determined locally from inside the domain. The normal velocity and speed of sound are 
determined from 
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"/«« = jCR* + R") 

= ^(R*-R1 


The Cartesian velocities are determined by decomposing the normal and tangential veloc- 
ity vectors: 


- j. x (- \ 

U face ~ U ref + |y^| ' U face ~ U ref ' 

, 

V face V ref |yj:| ^ U face U ref ) ^ ^ 

W face W ref |y js| ( u face U ref ) 

For inflow, ref => °° . For outflow, ref represents the values from the cell inside the 
domain adjacent to the boundary. 

The sign of the normal velocity U f ace = Uf ace + ^,/|V^| determines whether the 

condition is at inflow (U face < 0) or outflow {U face > 0). The entropy p/p 1 is deter- 
mined using the value from outside the domain for inflow and from inside the domain for 
outflow. The entropy and speed of sound are used to determine the density and pressure on 
the boundary: 


P face 


(° fare) 


2 - 17-1 


_ P face^Q face^ 


Note that when i2d = —1, the 1003 boundary condition is augmented by the far-field 
point-vortex correction 38 (for 2-d, x-z plane only). 
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6.1.5 Inviscid Surface 

bctype 1005 

• Cell-Center Points on Grid 
• O Cell-Face Boundary Points 

— Gradients on Boundary Edge 

Pi 

Figure 6-5. Inviscid surface boundary condition (bctype 1005) for density. 

The inviscid surface boundary conditions are cell-face type boundary conditions. The 
cell-face boundary values for density are approximated with the density values of the near- 
est cell-center points on the grid. With the points defined as in as Figure 6-5, 

Po = Pi < 6 ' 11) 

The boundary values for pressure are obtained in the same manner. 

The velocity component normal to the surface is set to zero in the following manner. 
Assume that the surface in Figure 6-5 is a k = constant surface, for which the metrics (unit 

normals) are t, x , t, v , and t , z . Then the normalized contravariant velocity (normal to the k 
direction) at cell center 1 is 

W 1 = u£ x + V 1 £y + W,£ z + £/ (6-12) 

The velocity components at the wall are then calculated using 

«o = M i “ 

v 0 = v 1 -C>-Wi < 6 - 13 > 

W'o = VV, 

/v 2 2 2 ... 

Using (£*) + (£ y ) + (£ z ) = 1 , it may be seen that W Q = 0 so that the normal velocity 

at the wall is zero. 

The gradient values for all five flow-field variables needed at the cell-face are obtained 
using two-point differences. For example, for density. 
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Vp = 2(p, - p 0 ) 


(6-14) 


6.1.6 Constant Enthalpy and Entropy Inflow 

bctype 1008 



w = 0 
p lx — 0 



Figure 6-6. Constant enthalpy and entropy inflow boundary conditions (bctype 1008). 


The constant enthalpy and entropy boundary condition (sometimes referred to as the 
wind tunnel inflow boundary condition) is a cell-center type condition. A grid set up to use 
the tunnel inflow condition should always have the x coordinate running along the length 
of the tunnel as shown in Figure 6-6. It is assumed that the entropy and the enthalpy are at 
the free-stream conditions. The v and w components of velocity are set to zero and the 
pressure gradient at the boundary is also zero. The density at the boundary is obtained 
from 


, = P- 


(6-15) 


The u component of velocity is obtained from 


H = 


2 2 
a i u 

y^T + T 


(6-16) 


The zero pressure gradient condition is used to set the pressure in the ghost cell equal to 
the nearest interior value. 


For running internal (wind tunnel type) flows, bctype 2003 is usually preferred as the 
inflow boundary condition over 1008, although both may work. For the corresponding 
wind tunnel outflow boundary condition, bctype 2002 should generally be used. 
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6. 1. 7 Singular Axis Using Half-plane Symmetry 

bctype 1011 


• Cell-Center Points on Grid 
O Cell-Center Boundary Points 


k 



Figure 6 - 7 . Singular axis with half-plane symmetry boundary condition (bctype 101 1). 


The singular axis using half-plane symmetry boundary conditions are cell-center type 
boundary conditions. As an example of this boundary condition, assume the singular axis 
occurs at k = 1. If jdim = 5, an i = constant plane might look like the one drawn in 
Figure 6-7. In the figure, the subscripts for p are j and then k (i.e. p j k ). The boundary 
values for density are assigned as 


Pi, — l = P4, 1 
P2, -l = P3, 1 
P3, -1 = P2, 1 
P 4 , -1 = Pi, 1 


Pi, -2 = P4, 2 
P2, -2 = P3, 2 
P3, -2 = P2, 2 
P 4, -2 = Pi, 2 


(6-17) 


The other four flow-field variables are assigned in a similar fashion; however, the normal- 
ized contravariant velocities and metrics are used to determine the correct signs for the 
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velocity components in a manner similar to boundary condition type 1001. First note that 
by the assumption of half-plane symmetry, the direction cosines on j = 1 are the same as 
j = jdim apart from the sign; let these metrics be denoted r^, t^,, and fj,. Then, for 
example, 


V 4,l = M 4, l^x + v 4, 1^ + ^4, + (6-18) 

«1,-1 = «4, 

v l,-l = v 4, l~ 2f \y^4, 1 (6-19) 

w l,-l = w 4, i - 2^V 4 , l 

6.1.8 Singular Axis Using Full Plane, Flux Specified 
bctype 1012 


• Cell-Center Points on Grid 
O Cell -Face Boundary Point 
Gradient on Boundary Edge 



Figure 6-e. Singular axis using full plane boundary condition (bctype 1012). 
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The singular axis using full plane boundary conditions are cell-face type boundary 
conditions. As an example of this boundary condition, assume the singular axis occurs at 
k = 1 . If jdim = 9, an i = constant plane might look like the one drawn in Figure 6-8. In 
the figure, the subscripts for p are j and then k (i.e. p y *). 

For the cell-face boundary point value of density (p 0 ), an average value of all the val- 
ues at k = 1 is obtained, i.e. 


Pj,o 


jdim - 1 

x p*. 


ZJL-l 

jdim - 1 


(6-20) 


The flux value is obtained with a two point extrapolation using p } and p 0 : 

(Vp). = 2( Pj - j - p y>0 ) < 6 ' 21 > 

The boundary values for all five flow-field variables are assigned as described for density. 

A known problem exists when using this boundary condition with the Baldwin-Lomax 
turbulence model. In such cases, the code employs the “wall” Baldwin-Lomax equation 
option rather than the “wake” Baldwin-Lomax equation option at the 1012 boundary. 


6.1.9 Singular Axis Using Extrapolation (Partial Plane) 

bctype 1013 

The singular axis using extrapolation boundary conditions are cell-center type bound- 
ary conditions. The ghost points are extrapolated from the computational domain. This 
boundary condition is used with singular axes for which neither boundary condition type 
101 1 or 1012 is appropriate (quarter planes, for instance). For example, the density bound- 
ary values would be approximated as 


P-2 - Pi 

The same first order extrapolation is used for the boundary values of the other flow-field 
variables. 

6. 1. 10 A Word About Singular Metrics 

Version 5.0 will automatically detect collapsed grid lines (e.g. singular metrics, cell 
faces with zero area) on block boundaries. (Collapsed grid lines in the “interior” of a block 
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are not allowed.) The detection of singular metrics is no longer keyed to the specification 
of either bctype 1011, 1012, or 1013. While these boundary conditions are still applicable, 
the new singular metric detection allows any other standard boundary condition that does 
not rely on the grid metrics at the boundary to be used as well. Note that the following 
boundary conditions rely on the grid metrics at the boundary and so should not be used on 
a singular face/face segment: 1001 (symmetry), 1005 (inviscid), 1003 (inflow/outflow), 
2003 (inflow with specified total conditions) and 2006 (radial equilibrium). 

When CFL3D detects singular metrics on a particular block, a message is written to 
the main output file (unit 1 1) indicating the location. It is always a good idea to verify that 
any singular block faces/face segments are in fact correctly detected. Metrics are treated as 
singular if the total area of a face/face segment is less than a parameter atol (set near the 
top of subroutine metric, in module lbcx.f). In certain cases, atol may need to be 
changed (increased in magnitude if faces that are known to be non-singular are flagged as 
singular and decreased if faces that are known to be singular are not flagged as such, in 
which case the code will give floating point overflow in subroutine metric). 


6.2 Physical Boundary Conditions with Auxiliary Data 

For the “2000” series of boundary conditions, auxiliary data is required. Therefore, 
ndata ^ 0. The following sections describe the boundary condition types for constant 
input data (ndata > 0). For these conditions, the information in “LT14 - 10 Boundary Con- 
dition Specification” on page 32 through “LT19 - KDIM Boundary Condition Specifica- 
tion” on page 35 is immediately followed by a header line, then a single data line with the 
ndata values appropriate for the particular boundary condition. Section 6.2.8 describes 
how to use the same boundary condition types with variable input data. 

Input values for bctype (i.e. boundary condition types currently supported) as follows: 


bctype 

boundary condition 

2002 

specified pressure ratio 

2003 

inflow with specified total conditions 

2004 

no-slip wall 

2005 

periodic in space 

2006 

set pressure to satisfy the radial equilibrium equation 

2007 

set all primitive variables 

2102 

pressure ratio specified as a sinusoidal function of time 
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6.2.1 Specified Pressure Ratio 

bctype 2002 

The specified pressure ratio boundary condition, generally used as the outflow bound- 
ary condition for internal flows, is a cell-center type boundary condition. A single pressure 
ratio, p/p „ , is specified on input. The parameter ndata must be set to 1 for the input 
pressure ratio value to be read. This pressure ratio is used to set both cell-center pressure 
boundary values (p_, and p_ 2 ). Extrapolation from inside the computational domain is 

used to set the boundary values for p , u, v , and w . See “Extrapolation on page 84. An 
example of the input lines is: 

p/pinf 

0.910 

When using bctype 2002 as the outflow condition for internal (wind tunnel type) 
flows, the tunnel Mach number and/or mass flow should be monitored and p/pinf adjusted 
accordingly to obtain the correct conditions. This is usually an iterative process. 

6.2.2 Inflow With Specified Total Conditions 

bctype 2003 

The inflow with specified total conditions boundary condition (sometimes referred to 
as an “engine inflow” boundary condition because it is often used to specify the conditions 
at an inflow face where an engine exhaust is located) is a cell-center type boundary condi- 
tion. The following five pieces of information are provided on input (ndata = 5): an esti- 
mated inflow Mach number (M g ), the total pressure ratio (p/p m ), the total temperature 

ratio and the flow directions (a and P) in degrees. These values are used as the 

external state in a 1-d characteristic boundary condition. An example of the input lines is: 

Mach Pt/Pinf Tt/Tinf Alphae Betae 

0.300 4.000 1.17555 0.0 0.0 

Boundary condition type 2003 is very similar to boundary condition type 1003 in that 
either interior or exterior values are chosen, depending on the sign of the characteristics at 
the boundary. One difference between them is that, while 1003 uses far-field reference- 
state levels for the exterior values, 2003 uses the total temperature, pressure, Mach num- 
ber, and flow angle that are input to determine the reference exterior values. Another dif- 
ference is the way the density and pressure boundary condition values are determined. 
Boundary condition type 1003 calculates these values as shown in Equation (6-10). 
Boundary condition type 2003 first determines a Mach number at the boundary using the 
velocities and speed of sound at the boundary (which were calculated through the charac- 
teristic method): 


I Hi 
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2 2 2 
U + V + w 

2 

a 


(6-23) 


It should be noted that the inflow Mach number may end up slightly different from the 
input M e for a converged solution. The pressure and density boundary conditions are then 
determined with 




(6-24) 


The boundary condition velocity components are determined the same way as for bound- 
ary condition type 1003. 


6.2.3 Viscous Surface 

bctype 2004 

The viscous surface boundary conditions are cell-face type boundary conditions. The 
no-slip condition (V = 0) is applied at the surface. Two pieces of auxiliary information 

are supplied on input (ndata = 2): the wall temperature (T w /T 0 G ) and the mass flow (C ), 

where C q = (pw„ orma /)/(pM) 00 • (C is zero if there is no flow through the wall.) An 
example of the input lines is: 

Twtype Cq 

0.95 - 0.05 

where 

Twtype > 0 sets T^/f^ = Twtype 

Twtype = 0 sets adiabatic wall 

Twtype < 0 sets T w at the stagnation temperature 

Cq < 0 results in mass flow in the direction of “decreasing” computational coordi- 
nate (i.e. C q < 0 results in suction on minimum wall, blowing on maximum 
wall) 

Cq > 0 results in mass flow in the direction of “increasing” computational coordi- 
nate (i.e. C > 0 results in blowing on minimum wall, suction on maximum 
wall) 

Cq = 0 results in no flow through the wall (same as old bctype 1004) 
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Note that for a dynamic grid, bctype 2004 gives no-slip relative to the moving wall. To 
set the wall velocity to zero relative to a non-moving reference frame when the mesh is 
moving, use -2004 instead of 2004; this option makes sense only if the grid motion is tan- 
gential to the surface. 

Also note that boundary condition type 2004 supersedes boundary condition types 
1004 and 2004 in previous versions of CFL3D. The main reason for the replacement is 
that 1004 relied on global parameters isnd and c2spe to determine whether adiabatic wall 
or constant-temperature wall conditions were invoked. As a consequence, all 1004 seg- 
ments had to be the same. Now, with 2004 (along with its additional data field Twtype), 
every no-slip wall segment can be set with different wall temperature conditions, if 
desired. Boundary condition type 2004 also allows for mass flow through the wall (suction 
or blowing) through the second additional data field Cq. 

The no-slip wall boundary condition is implemented as follows: 

• The nondimensional pressure on the body p b is determined through linear extrapola- 
tion: 

Pb = Pi-(P2-P0 /2 (6 - 25) 

But if p b < 0 , then p h = p, . Here the indices 1 and 2 indicate the first and second cell- 
center values away from the wall, respectively. 

• The nondimensional square of the speed of sound, variable c2, at the wall is next deter- 

2 * 

mined. (Note that c2 = (a w /a 00 ) = T w /T a 0 .) 

If Twtype > 0, c2 = Twtype. 

If Twtype < 0, c2 = 1 + •^y^(M 00 ) 2 • 
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where u mesh , v mesh , and w mesh are the velocity components of the mesh (they equal 0 
if the grid/body is not in motion). 

• Since 2004 is a cell-face boundary condition type (i.e. the boundary conditions and 
their gradient are applied at the cell face rather than in ghost cells), 

l Pb 

Pw c2 (6 . 27) 

P w — Pb 

The gradients at the wall for all the primitive variables are determined via 
Vp = 2p,-2p w ,etc. 

Note that smin is computed from viscous walls only. If a wall is inviscid, then as far as 
smin is concerned, it is invisible. This is important to remember when viscous boundary 
conditions are turned on after running a case inviscidly for some time since smin may 
never have been computed! 


6.2.4 Periodic (In Space ) 

bctype 2005 

The periodic boundary conditions are cell-center type boundary conditions. Four 
pieces of additional information must be input (ndata = 4). The number of the grid with 
which the current grid is periodic and the rotation angle (dQ x ,dQ y ,dQ z ) about one of the 

coordinate axes ( x , y, z ) are needed. Only one of the three angles can be used at a time and 
the other two angles must be identically zero. The angles should be determined from the 
right-hand rule. For example, if rotation is desired about the N axis (where N is either x, y 
or z , point the right-hand thumb in the direction of the +N axis. The fingers will curl in the 
direction of the positive angle. When setting the angle for a particular face (i.e. the i = 1 
face), set the angle of rotation equal to the angle that the periodic face would have to move 
through to get to this face. 

For a sample input, assume the current face on which the boundary condition is being 
set is j = 1 . The the following input will cause the current face to be periodic with the 
jdim face in grid 2, where a rotation of +45 degrees about the x axis would map the jdim 
face of grid 2 onto the j = 1 face of the current grid: 

ngridp dthx dthy dthz 

2 45.0 0.0 0.0 

At present, it is assumed that the current block and the block with which it is periodic 
match 1-1 at their corresponding faces after the rotation. Note that there is not a check for 
this! Also, the two blocks are assumed to be aligned similarly. That is i, j , and k on the 
first block must be defined exactly the same on the second block. For example, if the 
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k = kdim face of the current block has the periodic boundary condition applied to it, it is 
implicitly assumed that it is periodic with the k = 1 face of the specified second block 
and i and j run in the exact same directions on both blocks. Note that this means that two 
of the dimensions (idim and jdim in the example) must be the same on both blocks. 

The periodic boundary condition also works for a grid with one cell (two grid planes) 
in the periodic direction if the grid is set to be periodic with itself. Note, however, that if a 
particular block is periodic with a different block, then neither block should be only one 
cell wide in the periodic direction. 

In addition, the periodic boundary condition may be used for linear displacement, pro- 
vided the rotation angles are set to zero. Alternatively, the 1-1 block connection can be 
used (linear displacement only!). The 1-1 internal check will flag geometric mismatches, 
which should be equal to the desired linear periodic displacement. This is a good check of 
the input which is not available with boundary condition type 2005. 

Boundary condition type 2005 is a limited-use periodic (in space) boundary condition. 
For example, if one is solving for flow through a duct and it is known that the solution is 
periodic over 90 degrees (i.e. the solution is identical in each of the four quadrants of the 
duct), then a solution need only be obtained on a grid spanning 90 degrees, with periodic 
boundary conditions applied at the two edges. 

For an illustration of how this boundary condition works, consider Figure 6-9. This 
example is for flow through a 90 degree wedge (the flow direction is in the third dimen- 
sion, out of the page). The flow is periodic over 90 degrees, so periodic boundary condi- 
tions are applied at the j = 0 and j = jdim faces. 
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For density and pressure, boundary condition type 2005 sets: 

qjO(l) = q(jdim-l) 
q j 0(2) = q ( j dim-2 ) 

(6-28) 

qjO (3) = q(l) 
qjO (4) = q ( 2 ) 

The boundary conditions for the velocity components u , v , and w are assigned simi- 
larly, except that they are first rotated through the periodic angle, in this case 90° . For 
example, 


M i, bc = 33 °(£> *» 2> 1 ) = q O', k, i, 2) (unchanged) 

v i,bc = qj0(*,i, 3, 1) = q(j, k, i, 3)cos0 p — q(y, k, i, 4)sin8 p ( 6 - 29 ) 

w l,BC = 33 0(k, i, 4, 1 ) = q(j, k, i, 3)sin0 p + q(y, k, i, 4)cos0 p 

For an example of how this boundary condition can be used for linear displacement, 

see the 2-d vibrating plate sample test case in Section 9.1.6 on page 177. 


6.2.5 Radial Pressure Equilibrium 
bctype 2006 

Boundary condition type 2006 is a cell-center type boundary condition. Radial pres- 
sure equilibrium is used as a downstream boundary condition when it is desired to specify 
a pressure, but a large swirling component is present in the flow. Typically, this boundary 
condition would be used in turbomachinery applications in which a swirling flow is estab- 
lished by a rotor that is not corrected by the presence of stators or exit guide vanes. 

Four additional pieces of information are needed for this boundary condition type 
(ndata = 4). The grid number (ngridc) of the grid from which the integration of pressure 
is to be continued is specified. If the integration in this grid is not continued from another 
grid, input 0. A value for p/p ^ is input. If ngridc = 0, this value will be the starting value 

for the integration. If ngridc * 0, then the pressure value from the connecting point in 
grid ngridc is used as the starting value for the integration in the current block. The direc- 
tion in which integration is to proceed is specified with the parameter intdir. It may have 
an absolute value of 1, 2, or 3 for integration in the i, j , or k directions, respectively. The 
sign of intdir indicates whether the integration proceeds in the increasing (positive) or 
decreasing (negative) coordinate direction. The intdir direction must be the radial direc- 
tion. The fourth piece of information needed is the physical direction along which the 
radial axis lies, denoted with the parameter axcoord. It may have the values of +1, +2, or 
+3 for a radial axis aligned with the x, y , or z axes. The input lines for this boundary con- 
dition type would look like: 

ngridc P/Pinf intdir axcoord 
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0 0.9 +3 1 

The radial equilibrium condition requires that the pressure satisfy 

ip . 

dr F r 

where V 0 is the circumferential velocity component and r is the radius. The pressure 
ratio, p/p 0 is set at either the bottom or the top of the block face and then the radial 

equilibrium equation is integrated in either the increasing or decreasing radial direction to 
give the pressure at all other radii. The trapezoidal rule is used to perform the integration. 
The other flow-field variables (p, w, v, w) are extrapolated from inside the computational 
domain. See “Extrapolation” on page 84. 

This boundary condition assumes that one coordinate direction on the block face is 
essentially radial and the other is essentially circumferential and that the integration is 
being carried out in the radial direction. Since there is no way to verify this in the code, 
care must be exercised when using this boundary condition to insure that this and the fol- 
lowing restrictions are met. Continuation of the radial equilibrium condition through block 
boundaries is restricted to blocks that have the same orientation. For example, if the equi- 
librium condition is to be continued through a k boundary from an adjacent block, then i 
and j must run in the same direction in both blocks. This also implies that the k boundary 
must be k — 1 in one block and k — kdim in the second (i.e. the boundary can not be 
k = 1 in both blocks). Also, the segment must run the entire length of the block face in the 
direction in which the integration is being carried out. For example, if the integration is 
being carried out in the k direction, then ksta must be set to 1 and kend must be set to 
kdim. This restriction applies only if the integration is being continued from another 
block. 

Consider a case in which boundary condition 2006 is to be applied at an i = idim face, 
with j = constant radial lines (i.e. lines of constant angle 0) and k = constant circumfer- 
ential lines (i.e. lines of constant radius). Assume the block face lies in an x = constant 
plane, as shown in Figure 6-10. 

Assuming integration in the +k direction (intdir = 3), the pressure (1 = 5) in the first 
plane of ghost cells is obtained from 

qiO ( j , 1 , 5 , 3 ) = 

P*,,K y e) 2 l k.n 

qiO ( j , k, 5 , 3 ) = p kj = p k _ XJ + Ar kJ 

k,j 


( 6 - 31 ) 

k = 2, kdim - 1 
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fill 


6.2.5 Radial Pressure Equilibrium 




Figure 6-io. Radial pressure equilibrium boundary condition (bctype 2006) example. 

The velocity and density in the first layer of ghost cells is determined by zeroth order 
extrapolation from the adjacent interior points. For the case shown in Figure 6-10, the den- 
sity (l = 1) is obtained from 

qiO ( j , k, 1 , 3 ) - q ( j , k, idim-1 , 1 ) (6-34) 
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All flow quantities in the second layer of ghost cells are obtained by zeroth order 
extrapolation from the first layer of ghost cells: 

qiO (j ,k, 1=1-5, 4) = qiO ( j , k, 1 = 1-5, 3) (6-35) 

6.2.6 Specify All Primitive Variables 
bctype 2007 

Boundary condition type 2007 is a cell-center type boundary condition. It involves set- 
ting the boundary conditions with the five (ndata = 5) primitive variables, using standard 

CFL3D normalizations: p/p,*,, v/a OB , w/a and p/[p„„(<0 ] • An example of 

the input lines is: 

rho/rho_inf u/a__inf v/a_inf w/a__inf p/ { rho_inf *a_inf **2 ) 

1.0 0.3 0.0 0.0 0.71 

Note that the input pressure is not p/p x but rather p/VipJ) ■ Also note that the turbu- 
lence quantities are not currently allowed to be specified in the same way as the q s. 
Instead, they are extrapolated from the interior when bctype 2007 is employed. 

6.2.7 Specified Pressure Ratio As Sinusoidal Time Function 

bctype 2102 

The specified pressure ratio as a sinusoidal function of time boundary conditions are 
cell-center type boundary conditions. The pressure ratio, p/p oa , is specified as a sinusoi- 
dal function of time. The other flow-field variables (p, u, v, w) are extrapolated from 
inside the computational domain. Three pieces of additional information are specified on 
input (ndata = 4): the desired baseline (steady) pressure ratio ( p/p „), the amplitude of 

the pressure oscillation (A p/p m ), the reduced frequency of the pressure oscillation (k r ), 
and the “grid equivalent” of the dimensional reference length used to define the reduced 
frequency ( L ref ). The pressure will vary as 

Y p = -fi- + ^-s\n(2nk r t) (6-36) 

Poo Poo 

The reduced frequency is non-dimensionalized by 



where f is the frequency in cycles per second, L is a characteristic length and is the 
free-stream speed of sound. (Note that this definition of reduced frequency differs from 
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the “standard” definition k r = /L/|V|oo .) An example of the lines in the input file for this 
boundary condition is: 

p/pinf deltap/pinf rfreqp Iref 

0.910 0.001 175.93 1.0 


6.2.8 Variable Data for the 2000 Series 


To use this option, set ndata = -(the ndata used for the constant data value(s) as 
described above). Then, instead of the line containing the constant data value(s), substitute 
a line with the name (up to 60 characters) of a formatted file that has the appropriate array 
of data values. The data file will then be read with the following format: 

read ( iuni t , * ) header/title 

read ( iunit , * ) mdim, ndim, np mdim,ndim = cell-center dimensions of segment 

np = number of planes of ghost cell data 
read (iunit, *) nvaiues number of data values; nvaiues = abs(ndata) 

read (iunit, *) ( ( ( (bcdata (ro,n, ip, 1) , m=l,mdim) , n=l,ndim) , ip=l,np) , 

1=1 , nvaiues ) 


The roles of m, n vary depending on which face the segment is located: 


m, n — > j, k 
m , n — > k, i 
in , n — > j, i 


on the i = 1 and the i = idim faces where 
mdim = jend-jsta and ndim = kend-ksta 
on the 7 = 1 and the j = jdim faces where 
mdim = kend-ksta and ndim = iend-ista 
on the k = 1 and the k = kdim faces where 
mdim = jend-jsta and ndim = iend-ista 


Note that zeroes are not acceptable for mdim or ndim. Use the actual values of jdim-1, 
kdim-1, and/or idim-1 for the full face. Only boundary condition type 2007 can make use 
of two planes of data. For all other boundary conditions, set np = 1 . 


6.3 Block Interface Boundary Conditions 

For all the types of block interface boundary conditions, set bctype = 0. If bctype ^ 0, 
but block interface boundary conditions are set, the block interface boundary conditions 
will supersede. All block interface boundary conditions (one-to-one, patched, and overset) 
are cell-center type boundary conditions. 
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6.3.1 One-to-One Blocking 

(Input Line Types Twenty-Four through Twenty-Six) 

One-to-one (1-1) blocking, sometimes called C° continuous, means that the faces 
shared by two grids are exactly (to machine zero) the same. Several examples showing a 
variety of blocking strategies are discussed below. In the examples, the variable, 1, repre- 
sents the five flow-field variables. The sample inputs illustrate how the index ranges (ista 
to iend, jsta to jend, ksta to kend) in “LT25 - 1-1 Blocking Connections” on page 37 are 
assigned so that the correct communication between blocks is established. A good initial 
check to determine if the one-to-one blocking input is set up correctly is to compare the 
quantity of points in the range. For example, if two grids share a common portion of a j = 
constant face, the following must be true: 

[jend -jsta + l] gridl = [jend -jsta + 11^2 l®- 38 ) 

Keep in mind that j = constant faces can communicate with i = constant and/or k - con- 
stant faces as well (and vice versa), in which case the check will be 

[jend - jsta + l] gridl = [iend - Ista + l] grid2 (6-39) 


or 


jend - jsta + 1]^, = [kend - ksta + l] grid - (6-40) 

respectively. Note that Equation (6-38) through Equation (6-40) are necessary for a one- 
to-one interface to be specified correctly, but they are not sufficient; the direction in which 
the indices are input must be correct as well. (See Example 3 on page 106.) 

Example 1 


k Grid 1 
| 21x5x5 



k Grid 2 



Figure 6-ii. One-to-one blocking example 1 . 


As a simple illustration of 1-1 blocking, consider Figure 6-11. The figure shows an 
i — constant (not necessarily the same constant) face of two grids. Suppose communica- 
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tion is desired between the j = jdim face of grid 1 and the j = 1 face of grid 2. The perti- 
nent input would look something like: 

Line Type 


6 

NGRID 

NPLOT3D 

NPRINT 

NWREST 

ICHK 

I2D 

NTSTEP 

ITA 


2 

1 

0 

100 

0 


0 


1 

1 

8 

IDIM 

JDIM 

KDIM 









21 

5 

5 









21 

7 

5 








13 

GRID 

NBC 10 

NBCIDIM 

NBC J0 NBC JDIM 

NBCK0 

NBCKDIM 

IOVRLP 


1 

1 

1 

1 

1 


1 


1 

0 


2 

1 

1 

1 

1 


1 


1 

0 

16 

JO: GRID 

SEGMENT 

BCTYPE 

ISTA 

IEND 

KSTA 


KEND 

NDATA 


1 

1 

1003 

1 

21 


1 


5 

0 

17 

2 

1 

0 

1 

21 


1 


5 

0 

JDIM: GRID 

SEGMENT 

BCTYPE 

ISTA 

IEND 

KSTA 


KEND 

NDATA 


1 

1 

0 

1 

21 


1 


5 

0 


2 

1 

1003 

1 

21 


1 


5 

0 


1-1 BLOCKING DATA: 








24 

NBLI 

T 










25 

X 

NUMBER 

GRID : 

ISTA 

JSTA KSTA 

IEND 

JEND 

KEND 

ISVAl 

ISVA2 

26 

1 

1 

1 

5 1 

21 

5 


5 

1 

3 

NUMBER 

GRID : 

ISTA 

JSTA KSTA 

IEND 

JEND 

KEND 

ISVAl 

ISVA2 


1 

2 

1 

1 1 

21 

1 


5 

1 

3 


Note that in the sample input, both grids have the same value for idim. This does not have 
to be true. One grid can share only a portion of a face with another grid. 


The boundary conditions at the j - jdim face on any i plane, denoted il, of grid 1 would 
be set as: 


Grid 1 

Grid 2 

qj 0 ( 1414 . 3 ) = 

q( 1,1 42,1) 

qj0(2,il,l,3) = 

q(l,2,i2,l) 

qj 0(341,1,3) = 

q( 1,342,1) 

qj 0(4, i 1,1,3) = 

q( 1,442,1) 

qj 0(l,i 1,1,4) = 

q(2, 142,1) 

qj 0 (2,i 1 ,1,4) = 

q(2,2,i2,l) 

qj 0(3, i 1,1,4) = 

q(2,3,i2,l) 

qj 0(4, i 1,1,4) = 

q(2,4,i2,l) 
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The boundary conditions at the j = 1 face on any i plane, denoted i2, of grid 2 would be 
set as: 

Grid 2 Grid 1 

qj 0(1 424,1)= q(4, l,il,l) 

qj 0(2,i2,l,l)= q(4,2,il,l) 

qj 0(342,1,1)= q(4, 341,1) 

qj 0(442,1,1)= q(4,4,il,l) 

qj 0(1 424,2)= q(3, 1 ,i 1 ,1) 

qj 0(242,1,2)= q(3, 241,1) 

qj 0(342,1,2)= q(3, 341,1) 

qj 0(4,i2,l,2) = q(3,4,il,l) 

Example 2 


Grid 1 k k Grid 2 

21x9x3 | | 41x7x5 



Figure 6-12. One-to-one blocking example 2. 


A slightly more complicated example of 1-1 blocking is shown in Figure 6-12. Again, 
the figure shows an j = constant face (not necessarily the same constant) of two grids. In 
grid l, j is now a circumferential direction. Communication is desired between the j - 1 
and the j = jdim faces of grid 1 and the j = 1 face of grid 2. (In this example, it is 
assumed that the k = 1 boundary of grid 1 is a solid wall flat plate, so there is no 1-1 con- 
nectivity there.) The pertinent input would look something like: 

Line Type 


6 

NGRID 

NPLOT3D 

NPRINT 

NWREST 

ICHK 

I2D 

NTSTEP 

ITA 


2 

1 

0 

100 

0 

0 

1 

1 

8 

IDIM 

JDIM 

KDIM 







21 

9 

3 







41 

7 

5 






13 

GRID 

NBCI0 

NBCIDIM 

NBC JO 

NBCJDIM 

NBCK0 

NBCKDIM 

IOVRLP 


1 

1 

1 

1 

1 

1 

1 

0 


2 

1 

1 

2 

1 

1 

1 

0 

16 

JO: GRID 

SEGMENT 

BCTYPE 

ISTA 

IEND 

KSTA 

KEND 

NDATA 


1 

1 

0 

1 

21 

1 

3 

0 


2 

1 

0 

1 

21 

1 

5 

0 


2 

2 

1001 

21 

41 

1 

5 

0 

17 

JDIM: GRID 

SEGMENT 

BCTYPE 

ISTA 

IEND 

KSTA 

KEND 

NDATA 
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1101 21 13 0 

2 1 1003 1 41 1 5 0 

1-1 BLOCKING DATA: 

24 NBLI 

2 


NUMBER 

GRID 

: ISTA 

JSTA 

KSTA 

I END 

JEND 

KEND 

ISVAl 

ISVA2 

1 

1 

1 

1 

1 

21 

1 

3 

1 

3 

2 

1 

1 

9 

1 

21 

9 

3 

1 

3 

NUMBER 

GRID 

: ISTA 

JSTA 

KSTA 

I END 

JEND 

KEND 

ISVAl 

ISVA2 

1 

2 

1 

1 

3 

21 

1 

1 

1 

3 

2 

2 

1 

1 

3 

21 

1 

5 

1 

3 


Note how k ranges on grid 2 to coincide with the appropriate k points on the j = 1 and 
j = jdim faces of grid 1 . This sample input also shows how grid 1 can share only a portion 
of the j = 1 face of grid 2 in the i direction. 


The boundary conditions at the y = 1 face on any i plane, denoted i 1 , of grid 1 would be 
set as: 

Grid 1 Grid 2 

qj 0(1414,1)= q(l, 242,1) 

qj 0(2, i 1,1,1) = q( 1,142,1) 

q j 0(1 ,i 1 ,1,2) = q(2,2,i2,l) 

q j 0(2, i 1,1,2)= q(2, 142,1) 


The boundary conditions at the j = jdim face for the il plane of grid 1 would be set as: 

Grid 1 Grid 2 

qj0(l,il,l,3) = q(l,3,i2,l) 

qjo(2,i 1,1,3) = q(l,4,i2,l) 

q j o(141 4)4) = q (2, 3,i2,l) 

qj 0(2, i 1,1,4)= q(2,4,i2,l) 


The boundary conditions at the j = 1 face on any i plane, denoted i2, of grid 2 would be 
set as: 

Grid 2 Grid 1 

qj 0 ( 1424 , 1 ) = q( 1,24 14) 

q j o(2,i2,l, 1 ) = q( 1 , 1 4 1 4) 

qj 0(3,i2,l,l) = q(8,l,il,l) 

q j o(4,i2,l, 1 ) = q(8,2,i 1 ,1) 

qj 0(1 42,1,2)= q(2,2,i 1 ,1) 

qj 0(242,1,2)= q(2, l,il ,1) 

qj 0(3,12,1,2)= q(7 ,l,il ,1) 

qj0(4,i2,l,2) = q(7,2,il,l) 
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Example 3 


k Grid 1 



| Grid 2 

k 21 x 13 x 5 


Figure 6 - 13 . One-to-one blocking example 3. 

The previous two examples show 1-1 blocking over the entire k range of two grids. In 
some cases, only segments of faces will utilize 1-1 communication between grids. In 
Figure 6-13, two grids share a portion of a face beyond boundaries defined as inviscid sur- 
faces. Again, the figure shows an i = constant face (not necessarily the same constant) of 
two grids. Communication is desired between jsta = 5 and jend = 9 on the k = 1 face of 
grid 1 and jsta = 1 and jend = 5 on the k = 1 face of grid 2. The pertinent input would 
look something like: 

Line Type 


6 

NGRID 

NPL0T3D 

NPRINT 

NWREST 

ICHK 

I2D 

NTSTEP 

ITA 


2 

1 

0 

100 

0 

0 

1 

1 

8 

I DIM 

JDIM 

KDIM 







21 

9 

7 







21 

13 

5 






13 

GRID 

NBC 10 

NBC I DIM 

NBC JO 

NBCJDIM 

NBCK0 

NBCKDIM 

IOVRLP 


1 

1 

1 

1 

1 

2 

1 

0 


2 

1 

1 

1 

1 

2 

1 

0 

18 

KO: GRID 

SEGMENT 

BCTYPE 

I ST A 

I END 

JSTA 

JEND 

NDATA 


1 

1 

1005 

1 

21 

1 

5 

0 

c 

1 

2 

0 

1 

21 

5 

9 

0 

2 

2 

1 

0 

1 

21 

1 

5 

0 


2 

2 

1005 

1 

21 

5 

13 

0 


1-1 BLOCKING DATA: 


i in 
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24 

NBLI 

1 

NUMBER GRID 









25 

: I ST A 

JSTA 

KSTA 

I END 

JEND 

KEND 

ISVA1 

ISVA2 

26 

1 1 

1 

5 

1 

21 

9 

1 

1 

2 

NUMBER GRID 

: ISTA 

JSTA 

KSTA 

I END 

JEND 

KEND 

ISVA1 

ISVA2 


1 2 

1 

5 

1 

21 

1 

1 

1 

2 


Note that, since the j index runs in opposite directions on the two grids, one range is 
increasing and one range is decreasing in the 1-1 blocking input. It does not matter which 
grid’s range increases and which one decreases as long as they map the points in the cor- 
rect order. 

The boundary conditions at the k = 1 face from jsta to jend-1 on any i plane, denoted il, 
of grid 1 would be set as: 


Grid 1 

qk0(5,il,l,l) = 
qk0(6,i 1,1,1) = 

qk0(7,i 1,1,1) = 
qkO(8,il,I,l) = 
qk0(5,i 1,1,2) = 

qk0(6,il,l,2) = 

qk0(7,i 1,1,2) = 
qk0(8,il,l,2) = 


Grid 2 

q(4,l,i2,l) 

q(3,l,i2,l) 

q(2,l,i2,l) 

q(l,l,i2,l) 

q(4,2,i2,I) 

q(3,2,i2,l) 

q(2,2,i2,l) 

q(l,2,i2,l) 


The boundary conditions at the k = 1 face from jsta to jend-1 on any i plane, denoted i2, 
of grid 2 would be set as: 


Grid 2 Grid 1 

qk0(l,i2,l,l)= q(8, 1 ,il,l) 

qk0(2,i2,l,l)= q(7,l,il,l) 

qkO (342,1, 1 ) = q(6, 1 ,i 1 ,1) 

qk0(4,i2,l,l)= q(5, 1 ,i 1 ,1) 

qk0(l,i2,l,2) = q(8,2,il,l) 

qk0(2,i2,l,2)= q(7,2,il,l) 

qkO(3,i2,I,2) = q(6,2,il,l) 

qkO(3,i2,I,2) = q(5,2,il,l) 
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Example 4 


Grid 1 
5x5x21 




+ 

+ 



+ 

+ 



+ 

+ 



+ 

4- 










+ 

+ 



+ 

+ 





• 

• 



• 

• 


Grid 2 
21 x 5 x 7 


• • • • 


• • • • 


| Grid 3 

i 5x21x9 

Figure 6-14. One-to-one blocking example 4. 

The last example of 1-1 blocking involves three grids shown in Figure 6-14. In the fig- 
ure, a k = constant (denoted kl) plane of grid 1, an i = constant (denoted i2) plane of grid 
2, and a ; = constant (denoted j3) plane of grid 3 are shown. Communication between 
grids 1 and 2 is desired between the i = idim face of grid 1 and the j = 1 face of grid 2. 
Communication between grids 2 and 3 is desired between the k = 1 face of grid 2 and the 
i = 1 face of grid 3. The pertinent input would look something like: 


6 

NGRID 

NPLOT3D 


3 

1 

8 

IDIM 

JDIM 


5 

5 


21 

5 


5 

21 

13 

GRID 

NBCI0 


1 

1 


2 

1 


3 

2 

14 

10: GRID 

SEGMENT 


1 

1 


2 

1 


3 

1 


i 

l 

l 

BCTYPE 

1003 

1003 

1005 


NBC JO NBCJDIM 


I2D NTSTEP 
0 1 


NBCK0 NBCKDIM 
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15 


3 2 

0 


1 

21 

5 

9 

0 

IDIM: GRIDSEGMENTBCTYPE 

JSTA 


JEND 

KSTA 

KEND 

NDATA 



1 

1 0 

1 


5 

1 

21 

0 



2 

1 1001 

1 


5 

1 

7 

0 



3 

1 1000 

1 


21 

1 

9 

0 


16 

JO: 

GRID SEGMENT 

BCTYPE 


ISTA 

I END 

KSTA 

KEND 

NDATA 



1 1 

1000 


1 

5 

1 

21 

0 



2 1 

0 


1 

21 

1 

5 

0 



2 2 

1000 


1 

21 

5 

7 

0 



3 1 

1003 


1 

5 

1 

9 

0 

18 

K0: 

GRID SEGMENT 

BCTYPE 


ISTA 

I END 

JSTA 

JEND 

NDATA 



1 1 

1003 


1 

5 

1 

5 

0 



2 1 

0 


1 

21 

1 

5 

0 



3 1 

1003 


1 

5 

1 

21 

0 



1-1 BLOCKING DATA 








24 


NBLI 








25 

NUMBER GRID : 

ISTA 

JSTA 

KSTA 

I END 

JEND KEND ISVAl 

ISVA2 



1 1 

5 

1 

1 

5 

5 212 

3 

26 


2 2 

1 

1 

1 

21 

5 

1 1 

2 

NUMBER GRID : 

ISTA 

JSTA 

KSTA 

I END 

JEND KEND ISVAl 

ISVA2 



1 2 

21 

1 

5 

1 

1 

1 3 

1 



2 3 

1 

1 

9 

1 

21 

5 2 

3 


Notice that the i index range for grid 2 runs in the opposite direction of the k index 
range for grid 3 due to the right-hand rule. 


The boundary conditions at the i = idim face of grid 1 would be set as: 

Grid 1 Grid 2 

qi0(l,kl,l,3)= q(l,4,i2,l) 

qiO(2,kl,I,3) = q(l ,3.12,1) 

qi0(3,kl,l,3)= q(l)2,i2,I) 

qi0(4,kl.l,3)= q(l, 1,12,1) 

qiO(l ,kl ,1,4) = q(2,4,i2,l) 

qi0(2,kl,l,4)= q(2,3,i2,l) 

qi 0(3*1, 1,4) = q(2,2,i2,I) 

qi 0(4, k 1,1,4)= q(2,l,i2,l) 


The boundary conditions from ksta to kend-1 on the j = 1 face of grid 2 would be set as: 

Grid 2 Grid 1 

qj0(l,i2,l,l) = q(4,k 1,4,1) 

qjO(2,i2,I,l)= q(3,k 1,4,1) 

qj0(3,i2,l,l)= q(2,k 1,4,1) 

qj 0(4, i2, 1,1) = q(l ,kl ,4,1) 

qj 0(1,12,1,2)= q(4,kl ,3,1) 

qj 0(2,12,1,2)= q(3,kl ,3,1) 

qj 0(3, i2, 1,2) = q(2,kl ,3,1) 

qj 0(4,12,1,2) = q(l >kl ,3,1) 
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The boundary conditions at the k = 1 face of grid 2 would be set as: 

Grid 2 

Grid 3 

qk0(l,i2,l,l) = 

q(j3,8,l,l) 

qk0(2,i2,l,l) = 

d03,7,U) 

qkO(3,i2,I,l) = 

q(j3,6,l,l) 

qk0(4,i2,l,l) = 

q(j3, 5,1,1) 

qk0(l,i2,l,2) = 

q(j3, 8,2,1) 

qk0(2,i2,l,2) = 

q(j3, 7,2,1) 

qk0(3,i2,l,2) = 

q(j3, 6,2,1) 

qk0(4,i2,l,2) = 

q(j3, 5,2,1) 1 

i 

The boundary conditions from ksta to kend-1 on the / = 1 face of grid 3 would be set as: 

Grid 3 

Grid 2 

qi0(j3,5,l,l) = 

q(4, l,i2,l) 

qi0(j3,6,l,l) = 

q(3,l,i2,l) 

qi0(j3,7,l,l) = 

q(2,l,i2,l) 

qi0(j3, 8,1,1) = 

q(l,l,i2,l) 

qiO(J3,5,l,2) = 

q(4,2,i2,I) 

qiO(J3,6,I,2) = 

q(3,2,i2,l) 

qiO(J3,7,l,2) = 

q (2,2,i2,l) 

qi0(j3,8,l,2) = 

I 

i 

q(l,2,i2,l) 

i 

1 

— — ” ; 
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6.3.2 Patched-Grid Interpolation 

(Input Line Type Twenty-Seven) 
6.3.2. 1 General Information 



Figure 6-15. Patched-grid surface. 


This section describes the “basics” of patching in CFL3D and then shows a simple 
static patching example to illustrate the basic concepts. Next, an example of dynamic 
patching is given. Patched-grid interpolation is designed for communication between grids 
that share a common face, but are not C° continuous. For example, a global (3-d) grid is 
represented by the “box” in Figure 6-15. The grid must be right-handed as shown with the 
i , j , and k axes drawn in the figure. Patching may occur on an i = constant, j = constant, 
or k = constant surface. In the figure, an i = constant surface is indicated as the patched 
surface. Note that the adjacent grid involved in the patch is not shown in the figure. Patch- 
ing works best when the spacing of the adjacent grid in the normal direction to the patch is 
the same as that in the other grid. While the patch surface is shown as a plane, it may be 
non-planar as well. The local (2-d) indexing on the patch surface is indicated by the ^ and 
T) axes. 


The global and local indices correspond as follows (this is important when determin- 
ing the input parameters for dynamic patching in Section 3.42 on page 49): 


If the patch surface is on an i = constant surface (as shown in Figure 6-15), then 


k <=> T| 


(6-41) 


If the patch surface is on a / = constant surface, then 
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i <=> T1 
k <=> ^ 

If the patch surface is on a & = constant surface, then 

i o r| 


(6-42) 


(6-43) 


One grid may have multiple grids patched to it. For example, the flow over a nose cone 
illustrated in Figure 6-16 shows block 1 patched to both block 2 and block 3. Note that the 
orientation of grid lines in block 3 is different from that in blocks 1 and 2 to illustrate the 
features of the patching algorithm. 






6.3.2 Patched-Grid Interpolation 


To provide two-way communication between all blocks, a total of seven interpolations 
are required for this case, as follows: 

olation: Description : 

To i = idim of block 1 from i = 1 of blocks 2 and 3 (two “from” blocks) 

To i = 1 of block 2 from i = idim of block 1 
To i = 1 of block 3 from i = idim of block 1 
To j = 1 of block 2 from k = 1 of block 3 
To j = jdim of block 2 from k = kdim of block 3 
To k = 1 of block 3 from j = 1 of block 2 
To k = kdim of block 3 from j = jdim of block 2 

The interpolations may be input in any order (but must be consistent once the order is cho- 
sen). 

6.3. 2. 2 Description/Discussion of Input Parameters 

Basically, the patch algorithm works as follows. The interpolations are cycled through, 
one at a time, so that at any given time there is one surface being interpolated to. Note, 
however, that there may be more than one surface being interpolated from. In order to 
interpolate from one (or more) block(s) to another, interpolation coefficients are required. 
These are found by expressing the cell-center coordinates x c , y c , z c on the “to” side of the 

patch surface in terms of a nonlinear polynomial in y \ , where T| are the local coordi- 
nates on the “from” side of the patch surface. Newton iteration is used to invert the poly- 
nomial to find the local coordinates of the cell center, ^ c , tj c . 

Because of the nonlinearity of the equation, problems may arise in the iteration pro- 
cess. The parameters ifit, limit, and itmax may be adjusted to try to overcome any conver- 
gence difficulties. There must be ninter2 values for each of these three parameters. Limit 
is the maximum step size in £ or r\ allowed during the search procedure. The value 1 
seems to be a good general choice. Itmax is the maximum number of search steps allowed 
per grid point. A rule of thumb is limit x itmax = the maximum dimension of / , j , or k 
on a patch surface. 

Ifit controls the order of the polynomial fit used to relate x , y , or z to £ and r) . Ifit = 

1 for linear in both E, and t| (bilinear). Ifit = 2 for quadratic in both E, and T| (degenerate 
biquadratic). Ifit = 3 for quadratic in ^ , linear in T) . Ifit = 4 for linear in ^ , quadratic in T) . 

Some tips for choosing ifit are: 

• A grid with highly curved grid lines in one of the local directions will need a quadratic 
polynomial in that direction. 

• Refer to Section 6.3.2. 1 and the user’s own knowledge of the grid to decide which (if 
any) of the local directions b, or r| are highly curved. 

• Use the lowest order fit which seems reasonable in each direction. 
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. One-to-one patching can always be done with a bilinear fit, regardless of curvature. 

To and from are numbers containing attributes of the “to side of the patch surface and 
“from” side of the patch surface. For each of the ninter2 interpolations there is only 
one value of to, but there may be more than one value of from which is set by the parame- 
ter nfb. (Nfb is the number of blocks on the “from” side of the patch surface.) The values 
of to and from are of the form: 

to/from = Nmn 

where “N” indicates the block number; “m” indicates the coordinate which is constant on 
the patch surface (may differ on either side of the patch): 

m = 1 => i = constant 
m = 2 => j = constant 
m = 3 => k = constant 

and “n” indicates on which of the two possible m = constant surfaces the patch surface 
occurs: 

n = 1 for patch on m = 1 surface 
n = 2 for patch on m = mdim surface 

The following inputs pertain to the nose cone case in Figure 6-16: 

nfb from 

2 211,311 

1 112 

1 112 

1 331 
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Example 


k Grid 1 
| 21x5x9 


k Grid 2 



Figure 6-17. Patched-grid example. 


Suppose the k dimension of grid 1 in the first example of 1-1 blocking (see Figure 6- 
1 1 on page 102) was actually kdim = 9. Grid 1 might look something like that drawn in 
Figure 6-17. As in Figure 6-11, Figure 6-17 shows an i = constant face (not necessarily 
the same constant) of two grids. Notice that the spacing in the direction normal to the 
interface (i.e. j ) is approximately constant across the interface. 

In Version 5.0 of CFL3D, patched-grid interpolation data for static patched interfaces 
(interfaces that do not change with time) must be obtained as a preprocessing step. The 
code ronnie is designed for this task. Dynamic patched interfaces, such as occur when 
grids slide past one another, are computed internally in CFL3D. 

Note that, if two grids with very different sizes are patched together, it may be neces- 
sary to use a limiter on the gradients there. To do this, replace (hard- wire) the calls to int2 
with calls to int3 instead. 
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6.3.3 Chimera Grid Interpolation 
(Input Line Type Ten) 

Grid overlapping, also known as the overset-grid method or chimera technique, 
requires neither 1 - 1 connectivity nor a shared interface to pass flow information from one 
grid to another. With this method, a variety of grid topologies can be used together. The 
chimera implementation used in CFL3D is based on the method of Benek et al. 12 As a 
simplified example of grid overlapping, consider a cross section of a polar grid and a Car- 
tesian mesh as shown Figure 6-18. Suppose the grids overlap as in Figure 6-19. Since both 
grids cover the same area, computations on both grids in this area would be redundant. 
Therefore, certain points on the Cartesian grid will be eliminated from the computation. 
The polar grid is used to carve a “hole” in the Cartesian grid. In this example, the hole is 
defined as any cell-center point of the Cartesian grid interior to the k = 4 grid line of the 
polar mesh. The Cartesian mesh with the hole carved out is illustrated in Figure 6-20. Any 
cell center point of the Cartesian grid located within this hole is designated a “hole point”. 
The first two “nonhole” cell-center points of the Cartesian grid that border a hole point 
both vertically and horizontally are labelled “fringe points”. The remaining grid points 
that have not been designated as either hole or fringe points are called “field” points. 
Figure 6-21 depicts the hole, fringe, and boundary points for this example. Each fringe 
point of the Cartesian grid falls within a “target cell” of the polar grid. 

A searching algorithm is used to identify the particular eight points that define the 
hexahedral target cell. The search begins with an initial guess for the target cell. Next, the 
current target cell is isoparametrically mapped into a unit cube in computational space. 
The same transformation into the mapped coordinate system is then applied to the fringe 
point; if the mapped fringe point lies in the same unit cube as the current target cell, then 
that target cell in fact encases the fringe point. If the mapped fringe point lies outside the 
unit cube, then the current target cell is not the correct choice. However, the magnitude 
and direction of the mapped fringe point relative to the current target cell may be used to 
choose a new guess for the target cell. The mapping process is repeated until the correct 
target cell is identified. With the correct target cell identified, the data are transferred from 
the target cell to the fringe point with trilinear interpolation in computational space. Outer 
boundary values of the polar grid are determined in a similar manner. The MultiGeometry 
Grid Embedder (MaGGiE) code, written specifically for CFL3D by Baysal et al. 11 , is used 
to determine the interpolation information between grids. 
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Figure 6 - 18 . Grid-overlapping grid examples. 



Figure 6-19. Overlapped grids. 
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Figure 6-20. Hole in Cartesian grid in region of polar grid. 


• Hole Point for Cartesian Grid 
+ Fringe Point for Cartesian Grid 
O Boundary Point for Polar Grid 



Figure 6-21. Hole, fringe, and boundary points for overlapped grid example. 
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6.3.4 Embedded Mesh 

Regular refinement of coarse mesh 

Embedded grids are useful when high gradient areas are limited to an identifiable 
region (see reference 25). An embedded grid can be placed in that region to resolve the 
flow field without refining the entire mesh. As an example, an embedded grid scheme is 
shown in Figure 6-22 for two dimensions. The diagram represents full refinement in both 
directions. The solid lines define a finer mesh embedded completely within a coarser mesh 
depicted by the dashed lines. In the figure, a portion of the flow field is covered by both the 
embedded mesh and a portion of the coarser grid. The grids are coupled together during 
the solution process. The cell-center variables on a coarser grid cell which underlies a finer 
embedded grid cell are replaced with a volume-weighted restriction of variables from the 
four (2-d) or eight (3-d) finer grid cells, similar to the restriction operators used in a global 
multigrid scheme. 


• Embedded Grid Cell-Center Point 
+ Embedded Grid Boundary Point 


O Global Grid Cell-Center Point 



Figure 6-22. Embedded grid example. 


For the embedded grid, the computational boundaries occur either at a physical bound- 
ary, such as a wing, a symmetry plane, an inflow/outflow plane along a zonal interface 
(one-to-one, patched, or overset), or along an interior computational surface of a coarser 
grid. Along an interior surface, two additional lines of data corresponding to an analytical 
continuation of the finer grid cell centers are constructed from linear interpolation of the 
coarser grid state variables. An enlarged view of the lower-left comer of the embedded 
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mesh of Figure 6-22 is shown in Figure 6-23. Arrows indicate which coarse grid points are 
used in the linear interpolation scheme to obtain a couple of the boundary points drawn. If 
the input parameter iconsf = 1 (“LT20 - Mesh Sequencing and Multigrid”), then global 
conservation is enforced by replacing the coarse grid flux at an embedded grid boundary 
with the sum of the finer grid fluxes which share the common interface. If iconsf = 0, the 
coarse grid flux is computed using the volume-weighted restriction from the fine grid, and 
conservation is not insured. 


^ Embedded Grid Cell-Center Point 
+ Embedded Grid Boundary Point 
O Global Grid Cell-Center Point 



Figure 6 - 23 . Enlarged portion of embedded mesh. 


When designing an embedded mesh, it is important to remember that at least two lay- 
ers of coarse grid cells should surround the embedded boundaries unless the embedded 
boundary is set with a physical boundary condition (e.g. solid wall, plane of symmetry, or 
far-field) or a zonal boundary such as a one-to-one, patched, or overset type. In the exam- 
ple of Figure 6-22, there are two layers of coarse grid cells above and below the embedded 
mesh and three layers of coarse grid cells on the left and right sides of the embedded 
mesh. 


Suppose the grids in Figure 6-22 are in an i — constant plane. Also, jdim — 9 and 
kdim = 7 for the coarse grid and jdim = 5 and kdim — 5 for the embedded mesh. The per- 
tinent input would look something like: 
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Line Type 


6 

NGRID 

NPLOT3D 

NPRINT 

NWREST 

ICHK 

I2D 

NTSTEP 

ITA 


2 

1 

0 

100 

0 

0 

1 

1 

7 

NCG 

I EM 

I ADVANCE 

IFORCE 

IVISC(I) 

IVISC{J) 

IVISC(K) 



0 

0 

0 

0 

0 

0 

0 


8 

0 

1 

0 

0 

0 

0 

0 


IDIM 

JDIM 

KDIM 







21 

9 

7 







41 

5 

5 






10 

INEWG 

IGRIDC 

IS 

JS 

KS 

IE 

JE 

KE 


0 

0 

0 

0 

0 

0 

0 

0 


0 

1 

1 

4 

3 

21 

6 

5 

20 

MSEQ 

MG FLAG 

ICONSF 

MTT 

NGAM 





1 

0 

1 

0 

0 




22 

NCYC 

MGLEVG 

NEMBL 

NITFO 






1110 

In this example, the embedded mesh extends the entire length of the global grid in the 
i direction. The dimensions of the embedded mesh must satisfy a particular relationship to 
the data in “LT10 - Embedded Mesh Specifications”. The input parameters is, ie, js, je, ks, 
and ke are indices in the global grid to which the embedded mesh is connected. Thus, the 
following must be true: 


'^embedded = 2 ( ie " global + 1 l 6-44 ) 

Analogous relationships hold for the j and k directions. Note that the only exception to 
Equation (6-44) occurs in the i direction for 2-d cases, where is = 2, ie = 1 and 

idim em fr e dded ~ — 2 • 

There is also an option called “semi -coarsening” in which the number of points in the 
i direction are the same for the embedded grid and the global grid in the embedded region. 
This is helpful if there are sufficient points in the i direction, but grid enrichment in j — k 
planes is desirable. There is an internal check for this option and the only change in the 
input sample above is to set idim = 21 for the embedded grid as well. Note that semi- 
coarsening can only be used in the i direction. 

Another nice option with grid embedding is to add an embedded grid to a previously- 
run coarse grid problem. For instance, suppose a converged coarse grid solution is 
obtained and the flow field looks well resolved everywhere except in a vortex region. An 
embedded grid for that region can be tacked on to the original grid file and the case 
restarted. On the first run of the restart, set inewg = 1 for the embedded grid. This lets the 
code know that a solution not on the current restart file is beginning. On the next run, the 
embedded grid solution will be on the restart file, so set inewg = 0. 
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Convergence Acceleration 



In CFL3D, the convergence rate at which many problems are solved can be acceler- 
ated with the use of multigrid, mesh sequencing, or a combination of the two. The follow- 
ing sections describe the two techniques. The use of multigrid with grid overlapping and 
embedded grids is also discussed. 

Multigrid is a highly recommended option available in CFL3D. The improvement in 
convergence acceleration afforded with multigrid makes it very worthwhile to learn about 
and utilize. Table 7-1 illustrates this fact for two cases, a 2-d airfoil and a 3-d forebody. A 
work unit is defined here to be the “equivalent” fine grid iteration. For example, on the fin- 
est grid level, 1 iteration = 1 work unit; on the next-to-finest grid level, 1 iteration = 1/8(1/ 
4 in 2-d) of a work unit; on the next coarser level, 1 iteration = 1/64 (1/16 in 2-d) of a work 
unit; and so forth. The residual and lift coefficient convergence histories for these two 
cases are shown in Figure 7-1 and Figure 7-2. The term “full multigrid” implies that mesh 
sequencing is used in conjunction with multigrid. See “Mesh Sequencing” on page 134. 
Note that there is an additional CPU penalty for the overhead associated with the multigrid 
scheme that is not reflected in the work unit measure, however, for most problems, the 
overhead is small. 


Table 7-i. Convergence improvements with multigrid. 


Case 

Approximate Number of Work Units to Achieve the Final T ift 

Without Multigrid 


With Full-Multigrid 

2-d NACA 44 12 Airfoil 

10,000 

1000 

750 

3-d F- 1 8 Forebody 

» 1500* 

500 

500 


*This case was stopped after 1500 iterations when it became clear that the lift coefficient was far from converged 
and to continue running the case would have been a waste of computer resources. 
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Multigrid Acceleration - NACA 4412 Airfoil 

a =o.O° M_ = 0.2 Re 0 = 1.5x1 O' Spalart-Allmaras Model 




Figure 7-i. Convergence acceleration for 2-d NACA 4412 airfoil case. 


Multigrid Acceleration - F/A-18 Forebody 

a=30.0° = 0.34 Re c = 13.5x10' Spatart-Allmare* Model 5 Patched Zones 




Figure 7 - 2 . Convergence acceleration for 3-d F-18 Forebody case. 
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7.1 Multigrid 

7.1.1 Global Grids 

In a single-grid-level algorithm, the flow equations are solved only on the finest grid. 
The convergence rate for this algorithm is typically good during the initial stages of the 
computation but soon degrades significantly due to poor damping of low-frequency 
errors. 13 Multigrid methods, in which a sequence of coarser grids are used to eliminate the 
low-frequency errors, can significantly improve the convergence rate of the algorithm. The 
full-approximation-scheme multigrid algorithm, as developed and applied to inviscid 
three-dimensional flows in references 5, 6 and 7, is available in CFL3D to accelerate con- 
vergence of a solution to a steady state. A sequence of grids G 0 , G G N is defined, 

where G N denotes the finest grid and coarser grids are formed by successively deleting 

every other grid line in all three coordinate directions (except in 2-d, where the i direction 
is not coarsened). The fine grid serves to damp the high-frequency errors; the coarser grids 
damp the low-frequency errors. The coarse grids are solved with a forcing function on the 
right-hand side arising from restricting the residual from the finer meshes. The forcing 
function is the relative truncation error between the grids such that the solutions on the 
coarser meshes are driven by the fine grid residual. A correction is calculated on the 
coarser meshes and passed up to the next finest mesh using trilinear interpolation in the 
prolongation step. 

As an example, consider a 2-d grid of dimensions 17 x 17 as shown in Figure 7-3. 
Suppose it is desired to use four levels of multigrid, i.e. the fine grid level and three coarser 
grid levels. The three coarser grid levels, along with their dimensions, are also shown in 
Figure 7-3. Figure 7-4 illustrates a typical W-cycle multigrid scheme for four grid levels. 
In the figure, n refers to the current iteration. The multigrid cycle begins with a Navier- 
Stokes calculation performed at the finest grid level specified. The fine grid residual and 
flow-field variables are restricted to the next grid level where they are utilized to perform a 
Navier-Stokes calculation at this level. The process continues until the coarsest grid level 
is reached. After a Navier-Stokes calculation is performed at this level, the solution is pro- 
longated back “up” the cycle. With the W-cycle, additional calculations and the restric- 
tions and prolongation steps are repeated at the coarser grid levels giving the “W” pattern 
illustrated in Figure 7-4. The other option available is a V-cycle. An example of a V-cycle 
for the four grid level case is illustrated in Figure 7-5. Generally, a W-cycle is more effec- 
tive since additional work is done at the coarse grid level. However, this may be case 
dependent. Note that, if only two grid levels are specified, a V-cycle will always be per- 
formed even if a W-cycle is specified in the input file. 
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Figure 7 - 3 . Fine grid and coarse grid levels. 


NS: Navier-Stokes Calculation 
R: Residual/q Restriction 

P: Prolongation 



1 


Grid 

N 


N-l 


N-2 


N-3 


I 
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NS: Navier-Stokes Calculation 
R: Residual/q Restriction 

P: Prolongation Grid 



Figure 7-5. Multigrid V-cycle. 


For a multigrid W-cycle, the pertinent lines of input for the example in Figure 7-3 would 
look something like: 


5 

DT 

IREST 

IFLAGTS 

FMAX 

IUNST 

CFLTAU 



-1.0 

0 

0 

o 

t — 1 

0 

10.0 


6 

NGRID 

NPLOT3D 

NPRINT 

NWREST 

ICHK 

I2D 

NTSTEP 


1 

0 

0 

0 

0 

1 

1 

7 

NCG 

I EM 

I ADVANCE 

IFORCE 

IVISC(I) 

IVISC (J) 

IVISC (K) 

8 

3 

0 

0 

1 

0 

0 

0 

IDIM 

JDIM 

KDIM 





20 

2 

17 

17 





MSEQ 

MG FLAG 

ICONSF 

MTT 

NGAM 



22 

1 

1 

0 

0 

2 



NCYC 

MGLEVG 

NEMGL 

NITFO 




23 

200 

4 

0 

0 




MIT1 

MIT2 

MIT3 

MIT4 

MIT5 




1 

1 

1 

1 

1 




ITA 

1 


7.1.2 A Word About Grid Dimensions 

When determining how many multigrid levels are available for a particular grid, use 
the following formula: 


m f - \ m f + 1 

m c = -L— + 1 = -J 
c 2 2 


where is a fine-grid dimension (idim, jdim, or kdim) and m c is the corresponding 
coarse-grid dimension. Then rename m c as mj and compute Equation (7-1) again to 

determine an even coarser grid dimension. When m c is an even number, that is as coarse 
as that grid dimension can go. 
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For example, suppose a grid has idim — 37, jdim — 65, kdim — 65. The coarse grid 
below that would have idim = 19, jdim = 33, kdim = 33. The next coarser grid would 
have idim = 10, jdim = 17, kdim = 17. Since idim is an even number, that is as coarse as 
the grid can go; even though jdim and kdim can be reduced to coarser numbers, the entire 
grid is restricted by the idim =10 value. 

If the use of multigrid is desirable, it is important to plan ahead in the grid generation 
step of the computational problem. Choose grid dimensions that are “good” multigrid 
numbers, such as 129 (65, 33, 17, 9, 5, 3), 73 (37, 19), and 49 (25, 13, 7). Generally, two 
or three coarser grid levels are satisfactory. 

It is best if all grid segments are also multigridable (see LT14 - 10 Boundary Condi- 
tion Specification” on page 32 through “LT19 - KDIM Boundary Condition Specification” 
on page 35). For example, a face with jdim = 65 might have a portion from j = 1 to 17 as 
a one-to-one interface, a portion from ; = 17 to 41 as a viscous wall, and a portion from 
= 41 to 65 as a patched interface. Each of these segment lengths (7, 25, and 25) is multi- 
gridable down three levels. Note that CFL3D will sometimes work fine even if some grid 
segments are not multigridable: the code can assign indices on the coarser levels that 
denote different physical locations than the indices on the fine grid and still converge on 
the finest level. However, this does not work all the time. For example, if a C-mesh has a 
wrap-around dimension of jdim = 257 and the wake extends from j — 1 to 40 and j — 218 
to 257 (with one-to-one point matching), the code will create a coarser level with the wake 
from j = 1 to 20 and j = 109 to 129 (using Equation (7-1)). On this level, j = 20 is a phys- 
ically different point from j = 109 (it is not even the actual trailing edge), and will yield a 
boundary condition error when the code is run, because these points are expected to match 
in a one-to-one fashion. It is currently not necessary to specify laminar regions with multi- 
gridable numbers. See Note (3) on page 29 in the LT9 - Laminar Region Specification 
description. 

It is also important to consider the grid geometry when defining the grid dimensions. If 
multigrid is used, be sure to have any important geometric features (such as comers) 
located at multigridable points. Otherwise, on coarser levels, the geometry may change 
significantly, resulting in poor multigrid performance. 
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For a handy reference, the following table lists the grid sizes (< 1000) that are multi- 
gridable to three additional levels: 




Table 7-2. Grid sizes 

multigridable to three additional level. 


Grid: 

Cc 

>arser Le 

<u 

> 


| Coarser Levels: 

H Grid: 

Coarser Levels: 

9 

5 

3 

2 

aill 

173 

87 

44 

1 673 

337 

169 

85 

17 


5 

IH 

: ®Kil 

177 

89 

[“45 

£ 681 

341 

171 

86 

25 

■ 

IHH 

IH 


181 

91 

46 

1 689 

345 

173 

87 

33 

B 


■ 


185 

93 

47 

8 697 

349 

175 

~88 

41 



IH 

1 377 

189 

95 

48 

m 705 

353 

177 

89“ 

49 



7 

iBy 

^HHH 

193 

97 

49 

1 713 

357 

179 

90 

57 



8 

$■881 

197 

99 

50 

1 721 

361 

~wr 

91 

65 




n 

201 

101 

51 

i 729 

365 

183 

92 

73 

Hi 



"JH 

205 

103 

52 

1 737 

369 

185 

93 

81 

MM 



■ 417 

209 

105 

53 

i 745 

373 

187 

94 

89 

MM 



P 425 

213 

107 

54 

1 753 

377 

189 

“95 

97 

I 



1 433 

217 

109 

55 

1 761 

381 

191 

96 

105 

Hi 
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CHAPTER 7 Convergence Acceleration 


7.1.3 Overlapped Grids 


With the grid-overlapping scheme, interpolation stencils are determined at the finest 
grid level only. Therefore, information would be missing at the coarser grid levels of the 
multigrid scheme. To avoid the need to obtain interpolation stencils at the coarser grid lev- 
els prior to the computation and the corresponding problems that most likely will arise, the 
multigrid scheme has been modified to accommodate grid-overlapping cases. 24 

First, if a fine grid boundary is supplied overlap information as the boundary condi- 
tion, extrapolation is used for that boundary condition on all coarser grids. Second, for the 
restriction step of the multigrid scheme, all points are interpolated to coarser grids regard- 
less of whether or not they are in a hole at the fine grid level. The flow variables in the hole 
are simply at free-stream conditions. Finally, for the prolongation step, only corrections on 
field points are used to update the finest mesh solution. The hole points are not updated 
since they will be overwritten with free-stream values when a Navier-Stokes calculation is 
made at each fine grid level. Likewise, the fringe points are not corrected since they will 
be updated with flow information from other grids at the same fine grid level. 

Note that in Chapter 3 under “LT20 - Mesh Sequencing and Multigrid” on page 35, it 
is stated that the W-cycle is not recommended with overlapped grids. Therefore, set 
ngam = 1 . 

7.1.4 Embedded Grids 

For time advancement, embedded grids basically become an extension of the multigrid 
scheme. Consider the grid system shown in Figure 7-6. The finest global grid has dimen- 
sions 9x9 and there are two coarser global grids for multigrid purposes. In addition, 
there is a 7 x 13 grid embedded in the finest global grid as shown in the figure. The multi- 
grid (W-cycle) scheme would follow the course drawn in Figure 7-7. 


I II! 
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7.1.4 Embedded Grids 



Figure 7-6. One embedded mesh in finest global grid. 


NS: Navier-Stokes Calculation 
R: Residual/cj Restriction 

P: Prolongation Grid 



Figure 7-7. Multigrid W-cycle with one embedded grid level. 
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For a multigrid W-cycle, the pertinent lines of input for the example in Figure 7-6 
would look something like: 

Line Type 


5 

DT 

IREST 

IFLAGTS 

FMAX 

IUNST 

CFLTAU 




-1.0 

0 

0 

1.0 

0 

10.0 



6 

NGRID 

NPLOT3D 

NPRINT 

NWREST 

ICHK 

I2D 

NTSTEP 

ITA 


2 

0 

0 

0 

0 

1 

1 

1 

7 

NCG 

I EM 

IADVANCE 

IFORCE 

IVISC(I) 

IVISC(J) 

IVISC { K ) 



2 

0 

0 

1 

0 

0 

0 



0 

1 

0 

0 

0 

0 

0 


8 

IDIM 

JDIM 

KDIM 







2 

9 

9 







2 

7 

13 






10 

INEWG 

IGRIDC 

IS 

JS 

KS 

IE 

JE 

KE 


0 

0 

0 

0 

0 

0 

0 

0 


0 

1 

1 

4 

1 

2 

7 

7 

20 

MSEQ 

MGFLAG 

ICONSF 

MTT 

NGAM 





1 

1 

1 

0 

2 




22 

NCYC 

MGLEVG 

NEMGL 

NITFO 






200 

3 

1 

0 





23 

MIT1 

MIT2 

MIT3 

MIT4 

MIT5 





1 

1 

1 

1 

1 





For the boundary conditions on the embedded grid, use the appropriate physical or 
connectivity bctype on any face that lies along an edge of its parent grid and bctype = 0 
for any face that lies wholly within its parent grid. Suppose another embedded grid level is 
added to the grid system as in Figure 7-8. In the figure two grids are embedded in the first 
embedded grid. Note that only one embedded grid level is added by their addition. 
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Figure 7-8. Two embedded grids within an embedded grid. 
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7.1.4 Embedded Grids 


The corresponding input would resemble: 
Line Type 


5 

DT 

IREST 

IFLAGTS 

FMAX 

IUNST 

CFLTAU 




-1.0 

1 

0 

1.0 

0 

10.0 



6 

NGRID 

NPLOT3D 

NPRINT 

NWREST 

ICHK 

I2D 

NTSTEP 

ITA 


4 

0 

0 

0 

0 

1 

1 

1 

7 

NCG 

I EM 

I ADVANCE 

IFORCE 

IVISC(I) 

IVISC(J) 

I VI SC (K) 



2 

0 

0 

1 

0 

0 

0 



0 

1 

0 

0 

0 

0 

0 



0 

2 

0 

0 

0 

0 

0 



0 

2 

0 

0 

0 

0 

0 


8 

I DIM 

JDIM 

KDIM 







2 

9 

9 







2 

7 

13 







2 

5 

9 







2 

5 

5 






10 

INEWG 

IGRIDC 

IS 

JS 

KS 

IE 

JE 

KE 


0 

0 

0 

0 

0 

0 

0 

0 


0 

1 

1 

4 

1 

2 

7 

7 


1 

2 

1 

3 

1 

2 

5 

5 


1 

2 

1 

3 

9 

2 

5 

11 

20 

MSEQ 

MGFLAG 

ICONS F 

MTT 

NGAM 





1 

1 

1 

0 

2 




22 

NCYC 

MGLEVG 

NEMGL 

NITFO 






200 

3 

2 

0 





23 

MIT1 

MIT2 

MIT3 

MIT4 

MIT5 





1 

1 

1 

1 

1 





Note that inewg should be set to 0 for grids 3 and 4 if this case is restarted. 


Multigrid can also be performed at the embedded grid levels themselves by setting 
mgflag = 2. The embedded grid uses the coarser grid levels in which it is embedded, so 
ncg for the embedded grid itself should remain 0. The input for this case would resemble: 


Line Type 


5 

DT 

IREST 

IFLAGTS 

FMAX 

IUNST 

CFLTAU 




-1.0 

0 

0 

1.0 

0 

10 . 0 



6 

NGRID 

NPLOT3D 

NPRINT 

NWREST 

ICHK 

I2D 

NTSTEP 

ITA 


2 

0 

0 

0 

0 

1 

1 

1 

7 

NCG 

I EM 

I ADVANCE 

IFORCE 

IVISC(I) 

IVISC (J) 

IVISC (K) 



2 

0 

0 

1 

0 

0 

0 



0 

1 

0 

0 

0 

0 

0 


8 

IDIM 

JDIM 

KDIM 







2 

9 

9 







2 

7 

13 






10 

INEWG 

IGRIDC 

IS 

JS 

KS 

IE 

JE 

KE 


0 

0 

0 

0 

0 

0 

0 

0 


0 

1 

1 

4 

1 

2 

7 

7 

20 

MSEQ 

MGFLAG 

ICONSF 

MTT 

NGAM 





1 

2 

1 

0 

2 




22 

NCYC 

MGLEVG 

NEMGL 

NITFO 






200 

3 

1 

0 





23 

MITl 

MIT2 

MIT3 

MIT4 

MIT5 





1 

1 

1 

1 

1 
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7.2 Mesh Sequencing 

When setting up a CFD problem, initial conditions are set at every point on a grid. 
Usually, the closer the guess is to the final solution the quicker the case will converge. In 
CFL3D, the initial conditions for a problem are set at free-stream conditions for a single- 
grid-level case. However, if mesh sequencing is utilized, a better “guess” can be made for 
the initial conditions on the finer grid where the computations are most expensive. 

Suppose a solution is desired on the 9x9 grid depicted in Figure 7-9. Instead of start- 
ing the solution with free-stream conditions, a solution could first be obtained on the 5x5 
grid shown in Figure 7-10. While the solution on the 9 x 9 grid would be more accurate 
than that on the 5 x 5 grid, the coarser grid’s solution would be closer to the fine grid solu- 
tion than free-stream conditions. Since the coarse grid solution can be computed more 
quickly than the fine grid solution, it is usually beneficial to use the coarse grid solution as 
the initial condition for the fine grid. 



9x9 

Figure 7-9. Simple grid example. 



5x5 


Figure 7-10. Mesh sequencing sample grid. 

There are two ways to implement mesh sequencing in CFL3D. The first way is to com- 
pletely converge the solution on the coarse grid before mapping it up to the fine grid. For 
the sample grids, the pertinent input would look like: 

Line Type 


DT 

IREST 

IFLAGTS 

FMAX 

IUNST 

CFLTAU 



-1.0 

0 

0 

1.0 

0 

10.0 



NGRID 

NPLOT3D 

NPRINT 

NWREST 

ICHK 

I2D 

NTSTEP 

ITA 
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1 

0 

0 

0 

0 

1 

1 

7 

NCG 

I EM 

I ADVANCE 

IFORCE 

IVISC(I) 

IVISC(J) 

IVISC { K) 


2 

0 

0 

1 

0 

0 

0 

8 

IDIM 

JDIM 

KDIM 






2 

9 

9 





20 

MSEQ 

MGFLAG 

ICONSF 

MTT 

NGAM 




2 

1 

0 

0 

1 



22 

NCYC 

MGLEVG 

NEMGL 

NITFO 





200 

2 

0 

0 





0 

3 

0 

0 




23 

MIT1 

MIT2 

MIT3 

MIT4 

MIT5 




1 

1 

1 

1 

1 




1 

1 

1 

1 

1 




Note that multigrid is also employed. The coarse grid solution can be examined and, if 
the solution on the coarse grid is not converged, the case can be restarted on that grid. 
After the coarse grid solution is converged, the solution is mapped to the fine grid and the 
calculations continue at the fine grid level. The pertinent input for this step would look 
something like: 

Line Type 


5 

DT 

IREST 

IFLAGTS 

FMAX 

IUNST 

CFLTAU 




-1.0 

1 

0 

1.0 

0 

10.0 



6 

NGRID 

NPLOT3D 

NPRINT 

NWREST 

ICHK 

I2D 

NTSTEP 

ITA 


1 

0 

0 

0 

0 

1 

1 

1 

7 

NCG 

I EM 

I ADVANCE 

IFORCE 

IVISC (I) 

IVISC (J) 

IVISC (K) 



2 

0 

0 

1 

0 

0 

0 


8 

IDIM 

JDIM 

KDIM 







2 

9 

9 






20 

MSEQ 

MGFLAG 

ICONSF 

MTT 

NGAM 





2 

1 

0 

0 

1 




22 

NCYC 

MGLEVG 

NEMGL 

NITFO 






1 

2 

0 

0 






200 

2 

0 

0 





23 

MIT1 

MIT2 

MIT3 

MIT4 

MIT5 





1 

1 

1 

1 

1 





1 

1 

1 

1 

1 





Here, one iteration is performed on the coarse grid and two-hundred iterations are per- 
formed on the fine grid. At the end of this run, only the fine grid solution is available for 
examination. (So be sure to save the coarse grid solution before this step if it will be 
needed later for grid refinement studies, etc.) The case can be resubmitted for additional 
computations on the fine grid with the following input: 

Line Type 


5 

DT 

IREST 

IFLAGTS 

FMAX 

IUNST 

CFLTAU 



-1.0 

1 

0 

1.0 

0 

o 

o 
1 — 1 


6 

NGRID 

NPLOT3D 

NPRINT 

NWREST 

ICHK 

I2D 

NTSTEP 


1 

0 

0 

0 

0 

1 

1 

7 

NCG 

I EM 

IADVANCE 

IFORCE 

IVISC (I) 

IVISC(J) 

IVISC (K) 


2 

0 

0 

1 

0 

0 

0 

8 

IDIM 

JDIM 

KDIM 






2 

9 

9 





20 

MSEQ 

MGFLAG 

ICONSF 

MTT 

NGAM 
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1 

1 

0 

0 

1 

22 

NCYC 

MGLEVG 

NEMGL 

NITFO 



200 

3 

0 

0 


23 

MIT1 

MIT2 

MIT3 

MIT4 

MIT5 


1 

1 

1 

1 

1 


This input could be used until satisfactory convergence has been achieved. 

Even a partially-converged coarse grid solution is typically a better initial guess than 
free-stream conditions. Therefore, the second way to set up the mesh sequencing assumes 
that a set number of iterations at the coarse grid level will be adequate to improve the con- 
vergence at the fine grid level. If this is the case, the coarse grid solution is mapped to the 
fine grid on the first submittal. For example: 

Line Type 


5 

DT 

I REST 

IFLAGTS 

FMAX 

IUNST 

CFLTAU 



! 


-1.0 

0 

0 

1.0 

0 

10.0 



6 

NGRID 

NPLOT3D 

NPRINT 

NWREST 

ICHK 

I2D 

NTSTEP 

ITA 



1 

0 

0 

0 

0 

1 

1 

1 

1 

7 

NCG 

I EM 

I ADVANCE 

IFORCE 

IVISC (I) 

IVISC (J) 

IVISC (K) 




2 

0 

0 

1 

0 

0 

0 


j 

i 

8 

I DIM 

JDIM 

KDIM 








2 

9 

9 







20 

MSEQ 

MGFLAG 

ICONSF 

MTT 

NGAM 




- 


2 

1 

0 

0 

1 




i 

22 

NCYC 

MGLEVG 

NEMGL 

NITFO 





i 


200 

2 

0 

0 





1 


200 

3 

0 

0 





1 

[ 

23 

MITl 

MIT2 

MIT3 

MIT4 

mit5 






1 

1 

1 

1 

1 




S 


1 

1 

1 

1 

1 




w 


When an input like the one above is used, the coarse grid solution is not available for 
examination before proceeding to the fine grid. In addition, the restart file will contain the 
solution for the fine grid only. This is important to remember when a grid refinement study 
is being conducted (in which case the first approach to mesh sequencing would be benefi- 
cial). To restart from a run with the above input, use something like: 

Line Type 


5 

DT 

IREST 

IFLAGTS 

FMAX 

IUNST 

CFLTAU 




-1.0 

0 

0 

1.0 

0 

10.0 



6 

NGRID 

NPLOT3D 

NPRINT 

NWREST 

ICHK 

I2D 

NTSTEP 

ITA 


1 

0 

0 

0 

0 

1 

1 

* 1 

7 

NCG 

I EM 

I ADVANCE 

IFORCE 

IVISC (I) 

IVISC (J) 

IVISC (K) 



2 

0 

0 

1 

0 

0 

0 


8 

IDIM 

JDIM 

KDIM 







2 

9 

9 






20 

MSEQ 

MGFLAG 

ICONSF 

MTT 

NGAM 





1 

1 

0 

0 

1 




22 

NCYC 

MGLEVG 

NEMGL 

NITFO 






200 

3 

0 

0 





23 

MITl 

MIT2 

MIT3 

MIT4 

MIT5 





1 

1 

1 

1 

1 
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7.2 Mesh Sequencing 


One last note about mesh sequencing is to emphasize, as with multigrid, the advantage 
of “good” grid dimensions. See “A Word About Grid Dimensions” on page 127. Planning 
for mesh sequencing should be made at the grid generation step of the CFD problem. 
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CHAPTER 8 


Time-Accurate Computations 



Although most computations being performed today are for steady-state cases, it 
appears as though CFD will be used more and more for unsteady, time-accurate cases in 
the future. Therefore, since this realm is still somewhat in its infancy, this chapter has been 
written in order to explore in detail what is currently known about the subject, relative to 
CFL3D’s capabilities. 

CFL3D has been used extensively for time-accurate computations (dt > 0). See, for 
example, reference 33. Two types of sub-iterations, called “r-TS” and “x-TS” are cur- 
rently implemented in the code and are also described in this reference. This chapter 
describes the effects of the different types of sub-iterations, as well as the strategy for pur- 
suing time-accurate computations in general. 

When performing steady-state computations, the primary numerical accuracy issue 
about which the user needs to be concerned is that of spatial accuracy. Generally, the user 
runs a problem on a series of successively finer grids. As long as the solutions are fully 
converged on each grid, the user can get a clear picture of the accuracy of a solution on a 
given grid. In fact, the user can determine the numerical global order of accuracy by using 
a series of at least three grids from the same family and plotting some global quantity of 
interest as a function of a measure of the average grid spacing, such as 

l/( Vnumber of grid points) for 2-d or 1 /( Vnumber of grid points) for 3-d, on a log-log 
plot. The slope of the plotted line represents the spatial order of accuracy of the scheme. 
When the standard K = -1/3 scheme is employed, CFL3D has been demonstrated in the 
past to be globally approximately second-order accurate for most grids. However, this is 
problem-dependent and the accuracy can degrade somewhat on grids that are too coarse or 
on grids with extremely severe stretching. 

For time-accurate problems, temporal accuracy becomes an additional numerical 
accuracy issue of concern for the user. Now, not only does the effect of the grid need to be 
assessed for each problem, but the effect of the time step as well. Additionally, because 
CFL3D is an implicit code and employs approximate factorization, linearization and fac- 
torization errors are introduced during each time step, which can degrade the accuracy of 
the time-accurate simulation. (In fact, if no sub-iterations are employed, the best that can 
possibly be hoped for is first-order temporal accuracy.) This is why sub-iterations are gen- 
erally recommended for time-accurate computations. Sub-iterations “iterate away” the lin- 
earization and factorization errors. The more sub-iterations performed, the more accurate 
the simulation. But how many sub-iterations are enough? And which type of sub-iteration 
scheme works the best? Hopefully, this chapter will help to answer these questions. 
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8.1 General Effects of Numerical Parameters 

A graphic representing the general effects of sub-iterations, time step, and grid is 
shown in Figure 8-1. Here, some “quantity of interest” is shown as a function of time step. 
For example, the quantity could represent Strouhal number for an unsteady circular-cylin- 
der case. Say that the user ran a series of computations on a given grid, using three sub- 
iterations. Each successive computation used a smaller and smaller time step and each was 
completely converged to periodic quasi-steady-state. If the user plotted a global quantity 
of interest as a function of time step, a curve like the lower-most curve in the figure might 
be obtained. (Note that the figure shows the quantity of interest increasing with decreasing 
time step, but the trend could also be in the opposite direction, depending on the case and 
the quantity of interest chosen.) 


CO 

<D 

i— 

<D 

_C 

O 

& 

c 

CC 

D 

o 


/ 


“true” answer on infinitely-fine grid 
and infinitely-small time step 


region of true 
second-order 
temporal accuracy 


increasing 
grid size 



-T- region of true 
. 1 second-order 
- 1 - spatial accuracy 


increasing 

sub-iterations 


Decreasing time step 


Figure 8-1. Time accuracy trends. 


Now say that the user repeated the entire series of computations, except this time using 
six sub-iterations instead of three. A curve similar to the second curve from the bottom of 
the figure might be obtained. Finally, with an infinite number of sub-iterations per time 
step, the user would obtain the dashed curve, which represents the best possible solution 
on that grid. Note that, using a given time step, an increasing number of sub-iterations 
yields an increasingly better answer, but even the best answer (with infinite sub-iterations) 
is still in error from the answer using an infinitely-small time step. 

The dashed line should behave either first or second order accurate in time (depending 
on the accuracy input by the user in the input file), but only for sufficiently small time 
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steps. This is what is graphically represented by the left horizontal arrow in the figure. If 
the time step is too large, the solution may not exhibit the expected temporal accuracy. 

It is evident from this figure that, if an extremely small time step is taken, then sub- 
iterations are not as beneficial as when larger time steps are taken. The solution is already 
pretty good. Hence the user needs to make a trade-off between accuracy and efficiency. An 
extremely small time step can be taken, but at a greater cost, or a larger time step can be 
taken with some degradation in accuracy. And, sub-iterations may or may not contribute 
much toward improving accuracy, depending on the time step. Also, at one time step a cer- 
tain number of sub-iterations may be enough, but at a different time step that same number 
may be either insufficient or overkill. 

The effect of the grid size is also represented in Figure 8-1. On finer and finer grids, 
the location of the dashed curve will change, approaching the “true” answer on an infi- 
nitely-fine grid. (Note that the figure shows the quantity of interest increasing with finer 
grids, but it could also go the opposite direction, depending on the case and the quantity of 
interest chosen.) The standard k = -1/3 CFL3D scheme should generally behave spa- 
tially second-order accurate on sufficiently fine grids. The filled-in circle in the figure rep- 
resents the “true” answer on an infinitely fine grid with an infinitely small time step. 
Obviously, the user would generally like to get as close to this answer as possible, but with 
a reasonable expenditure of resources. 


8.2 Effect of Sub-iterations With Time Step and Grid Size 


The effect of sub-iterations with time step and grid size is explored in this section for a 
sample test case of laminar flow over a circular cylinder at Reynolds number 1200 and 
M x = 0.2 . The input file, for a relatively fine O-grid with t -TS multigrid sub-iterations, 
is given here: 


cylnew.bin 
plot 3dg . bin 
plot 3dq . bin 
cf 13d . out 
cf 13d . res 
cf 13d. turres 
cf 13d . blomax 
cf 13d. outl5 
cf 13d .prout 
cf 13d. out20 
ovrlp . bin 
patch . bin 
restart . bin 


circ cylinder 


XMACH 

ALPHA 

BETA 

REUE, MIL 

TINF , DR 

IALPH 

IHIST 

0.2000 

00.000 

0.0 

0.0012 

460.0 

0 

0 

SREF 

CREF 

BREF 

XMC 

YMC 

ZMC 


1 . 00000 

1.00000 

1.0000 

0.00000 

0.00 

0.00 


DT 

IREST 

IFLAGTS 

FMAX 

IUNST 

CFLTAU 


+0.1000 

0 

000 

05.0000 

0 

5. 


NGRID 

NPLOT3D 

NPRINT 

NWREST 

ICHK 

I2D 

NTSTEP 

1 

1 

1 

6100 

0 

1 

0100 

NCG 

I EM 

I ADVANCE 

IFORCE 

IVISC(I) 

IVISC (J) 

IVISC (K) 
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2 

I DIM 
2 

ILAMLO 

0 

INEWG 

0 

IDIAG(I) 

1 

IFDS(I) 

1 

GRID 

1 

10: GRID 

1 

IDIM : GRID 
1 

JO : GRID 

1 

JDIM : GRID 


0 

0 

1 

0 

1 

1 


JDIM 

KDIM 






193 

97 






ILAMHI 

JLAMLO 

JLAMHI 

KLAMLO 

KLAMHI 



0 

0 

0 

0 

0 



IGRIDC 

IS 

JS 

KS 

IE 

JE 

KE 

0 

0 

0 

0 

0 

0 

0 

IDIAG(J) 

IDIAG(K) 

IFLIM(I) 

IFLIM ( J ) 

IFLIM (K) 



1 

1 

0 

0 

0 



IFDS(J) 

IFDS(K) 

RKAP0 ( I ) 

RKAP0 ( J) 

RKAP0 (K) 



1 

1 

0.3333 

0.3333 

0.3333 



NBC 10 

NBCIDIM 

NBC JO 

NBC JDIM 

NBCK0 

NBCKDIM 

IOVRLP 

1 

1 

1 

1 

1 

1 

0 

SEGMENT 

BCTYPE 

JSTA 

JEND 

KSTA 

KEND 

NDATA 

1 

1001 

0 

0 

0 

0 

0 

SEGMENT 

BCTYPE 

JSTA 

JEND 

KSTA 

KEND 

NDATA 

1 

1002 

0 

0 

0 

0 

o 

SEGMENT 

BCTYPE 

ISTA 

I END 

KSTA 

KEND 

NDATA 

1 

0 

0 

0 

0 

0 

0 

SEGMENT 

BCTYPE 

ISTA 

I END 

KSTA 

KEND 

NDATA 

1 

0 

0 

0 

0 

0 

0 

SEGMENT 

BCTYPE 

ISTA 

I END 

JSTA 

JEND 

NDATA 

1 

2004 

0 

0 

0 

0 

2 | 

TWTYPE 

CQ 





1 

0. 

0. 






SEGMENT 

BCTYPE 

ISTA 

I END 

JSTA 

JEND 

NDATA 

1 

1003 

0 

0 

0 

0 

0 

MGFLAG 

ICONSF 

MTT 

NGAM 




1 

0 

0 

01 




EPSSSC ( 1 ) 

EPSSSC ( 2 ) 

EPSSSC (3) 

ISSR 

EPSSSR ( 1 ) 

EPSSSR (2 ) 

EPSSSR { 3 ) 

0.3 

0.3 

0.3 

0 

0.3 

0.3 

0.3 

MGLEVG 

NEMGL 

NITFO 





03 

00 

000 





MIT2 

MIT3 

MIT4 

MIT 5 

MIT6 

MIT7 

MIT8 

01 

01 

01 

01 

1 

1 

1 


0 0.3 

NCYC MGLEVG 

10 03 

MITl MIT2 

01 01 

1 BLOCKING DATA: 
NBLI 

1 


NUMBER 

GRID 

: ISTA 

JSTA 

KSTA 

I END 

JEND 

KEND 

ISVAl 

ISVA2 

1 

1 

1 

1 

1 

2 

1 

97 

1 

3 

NUMBER 

GRID 

: ISTA 

JSTA 

KSTA 

I END 

JEND 

KEND 

ISVAl 

ISVA2 

1 

1 

1 

193 

1 

2 

193 

97 

1 

3 


PATCH SURFACE DATA: 
NINTER 
0 

PLOT 3D OUTPUT: 

BLOCK IPTYPE I START 

10 1 

MOVIE 
0 

PRINT OUT: 

BLOCK IPTYPE I START 
10 1 

CONTROL SURFACE: 

NCS 

0 

GRID ISTART I END 


IINC J START 
1 01 


IINC JSTART 
1 01 


TEND JINC KSTART KEND 

999 1 1 999 


TEND JINC KSTART KEND 

999 1 1 999 


JSTART JEND KSTART KEND IWALL INORM 


The initial study is to investigate the effect of number and type of sub-iterations on the 
sub-iteration convergence of residual and drag. These levels are printed out automatically 
to the file cf 13d . subit_res (unit 23). (See Section 5.2.2.) 
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For this study, the following runs were performed (the coarser grid consists of every 
other point from the fine grid): 


Grid 

At 

Sub-iteration Tvpe 

97x49 

0.02 

f-TS, multigrid 

97x49 

0.02 

f-TS, no multigrid 

97x49 

0.02 

X-TS, multigrid 

97 x49 

0.02 

x-TS, no multigrid 

97 x49 

0.10 

f-TS, multigrid 

97 x49 

0.10 

f-TS, no multigrid 

97x49 

0.10 

x-TS, multigrid 

97x49 

0.10 

x-TS, no multigrid 

97x49 

0.50 

f-TS, multigrid 

97x49 

0.50 

f-TS, no multigrid 

97x49 

0.50 

x-TS, multigrid 

97x49 

0.50 

X-TS, no multigrid 

193 x 97 

0.10 

f-TS, multigrid 

193 x 97 

0.10 

f-TS, no multigrid 

193x97 

0.10 

x -TS, multigrid 

193 x 97 

0.10 

x -TS, no multigrid 


When multigrid was employed, a 3-level V-cycle was used. 

Figure 8-2 shows the residual for density and the drag coefficient as a function of ncyc 
(number of sub-iterations +1) at a time step of 0.02. This is a fairly fine time step, yielding 
over 1000 steps per period. At this time step, both the f-TS and x-TS with multigrid con- 
verge the drag with ncyc = 4 (3 sub-iterations) and f-TS and x-TS without multigrid 
require about ncyc = 6 (5 sub-iterations). The residual also converges quicker with multi- 
grid, as expected. Note that the f-TS with multigrid has a slightly better residual conver- 
gence rate than x-TS with multigrid at this time step. 

At a higher time step of dt = 0.10, the trends in Figure 8-3 are similar: both f-TS and 
x -TS with multigrid converge the quickest, requiring about ncyc = 5, while the non-multi- 
grid methods require about ncyc = 14-16. At this time step, the residual for x-TS with 
multigrid converges slightly better than f -TS with multigrid. This time step corresponds to 
a little over 200 steps per period. 
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Coarse grid, dt=0.02 


Coarse grid, dt=0.02 


t-TS, MG 
t-TS, no MG 
tau-TS, MG 
tau-TS, no MG 


1.3790 


1.3785 


t-TS, MG 
t-TS, no MG 
tau-TS, MG 
tau— TS, no MG 


Cd 1.3780 


1.3775 \- 


1.3770 


0 4 8 12 16 20 

NCYC ( = subiterations+ 1 ) 

(a) 


0 4 8 12 16 20 

NCYC ( = subiterations+ 1 ) 

(b) 


Figure 8-2. Coarse grid residual and drag coefficient histories for a single time step of 

At = 0.02. 


Coarse grid, dt = 0. 1 0 


t-TS, MG 

t-TS, no MG 

tau— TS, MG 

. tau-TS, no MG 


Coarse grid, dt=0.10 


1.500 - \ 

\ 

Cd 1-495 - \ 


t-TS, MG 

t-TS, no MG 

tau— TS, MG 

tau— TS, no MG 



0 4 8 12 16 20 

NCYC ( = subiterations+ 1 ) 

(a) 


0 4 8 12 16 20 

NCYC ( = subiterations+ 1 ) 

(b) 


Figure 8-3. Coarse grid residual and drag coefficient histories for a single time step of 

At = 0.10. 
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At the highest time step of dt = 0.5, Figure 8-4, the multigrid sub-iterations require 
about ncyc =12, while the non-multigrid sub-iterations are not fully converged even after 
ncyc = 40. Also note from Figure 8-4(a), at this time step the residual for /-TS with multi- 
grid method now does not converge as well as either t -TS method. This time step corre- 
sponds with less than 50 steps per period. 


Coarse grid, dt = 0.50 


Coarse grid, dt=0.50 



(a) 



NCYC ( = subiterations+ 1 ) 

(b) 


Figure 8-4. Coarse grid residual and drag coefficient histories for a single time step of 

At = 0.50. 


Results for the fine 193 x 97 grid with dt = 0.1 are shown in Figure 8-5. Results are 
qualitatively similar to those in Figure 8-3. However, on this finer grid, more sub-iterations 
are required to converge the drag: 6-8 iterations for multigrid and well over 20 iterations 
for non-multigrid. 

With a 3-level V-cycle, the multigrid method costs roughly 1.5 times as much as the 
non-multigrid method. (The x-TS is only marginally more expensive than f-TS, so they 
may be considered essentially equivalent.) Hence, at the smallest time step of dt = 0.02, 
the user is roughly at a break-even point in terms of whether it is more efficient to use mul- 
tigrid or no multigrid. However, at the larger time steps, using multigrid is clearly benefi- 
cial: for example, at dt = 0. 1 (around 200 steps per cycle), multigrid converges the drag in 
approximately 0.36 the number of sub-iterations on the coarse grid at 1.4 times the cost; 
this means a savings of almost 50% ! The savings is even greater on the fine grid. Due to 
this substantial savings, the remaining results will include only cases utilizing multigrid. 
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Fine grid, dt=0.10 


Fine grid, dt=0.10 


t-TS. MG 
t-TS, no MG 
tau— TS, MG 
tau— TS, no MG 


,\ 

Cd 1.368 - \\ 


t-TS, MG 
t-TS, no MG 
tau-TS, MG 
tau— TS, no MG 


1.364 F W 


0 4 8 12 16 20 

NCYC ( = subiterations+ 1 ) 

(a) 


0 4 8 12 16 20 

NCYC ( = subiterations+ 1 ) 

(b) 


Figure 8-5. Fine grid residual and drag coefficient histories for a single time step of 

At = 0.10. 


Coarse grid, dt = 0.10 

Q t-TS. MG 
-.Q.. tau-TS, MG 



0 2 4 6 8 

NCYC ( = subiterations+ 1) 

(a) 


x 1.56 

CO 


(J 1-54 


Coarse grid, dt = 0. 10 


t-TS, MG 


tau-TS, MG 


0 2 4 6 8 

NCYC ( = subiterations+ 1 ) 

(b) 


Figure 8-6. Coarse grid Strouhal number and lift coefficient histories for fully periodic 

solutions using At = 0.10. 
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Figure 8-2 through Figure 8-5 give a feel for the effect of sub-iterations on the conver- 
gence to the next physical time step for one iteration, but what is the effect of the number 
of sub-iterations on global quantities, over a long period of time? Figure 8-6 shows Strou- 
hal number and maximum lift coefficient (in absolute value) as a function of ncyc for dt = 
0.10 on the coarse grid, where the solution is obtained using the given value of ncyc over a 
long time (until periodic quasi-steady-state is reached). If at least 4 sub-iterations are run 
for this case (ncyc = 5), both t -TS and x -TS with multigrid converge to the same result. 
This is consistent with the results for maximum lift coefficient shown in Figure 8-3(b). 
However, if less than this number of sub-iterations is run, then the t -TS method appears to 
give the better result. 

For the higher time step of dt = 0.5, results are shown in Figure 8-7. If ncyc is less 
than about 7 for this time step, both t -TS and x -TS sub-iterations with multigrid yield 
non-physical solutions (not shown in the figures). For example, t-TS yields a highly non- 
regular lift cycle, while x-TS yields a regular lift cycle with non-zero mean. At least ncyc 
= 15-20 is required to converge the sub-iterative schemes sufficiently at this time step. 
This is roughly consistent with the results in Figure 8-4(b). If less than this number of sub- 
iterations is used, then the x -TS method gives the better result. This is the opposite result 
from that given above for dt = 0. 1 , but it is consistent with the trend seen in the residual 
plots of Figure 8-2(a), Figure 8-3(a), and Figure 8-4(a). In other words, it appears that the 
t -TS method may require less sub-iterations at low time steps, while x -TS requires less 
sub-iterations at higher time steps. 


Coa r se grid, dt = 0.50 



NCYC ( = subiterations+ 1 ) 

(a) 


Coarse grid, dt = 0.50 


1.70 

1.66 

1.62 

x 

CD 

£ 1.58 


o 


1.54 - 
1.50 - 
1.46 


non-physical behavior 

t-TS, MG 
..0.. tau— TS, MG 



0 4 8 12 16 20 

NCYC (=subiterations+ 1 ) 

(b) 


Figure 8-7. Coarse grid Strouhal number and lift coefficient histories for fully periodic 

solutions using At = 0.50 . 
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Other time-accurate circular cylinder cases with turbulence model(s) employed (not 
shown), have revealed similar trends to the study shown here One point worth mentioning 
in connection with these other cases is that, in some instances, the / -TS method with mul- 
tigrid has been seen to either diverge or else give nonphysical answers, regardless of the 
number of sub- iterations taken, when the time step is too large. Unfortunately, determin- 
ing what time step is too large remains elusive at this point. Trial and error seems to be the 
only way to determine it for such cases. Therefore, since the x-TS method has not exhib- 
ited such errant behavior, it appears that, as a general rule, the safest bet is to go with the 
x-TS method rather than /-TS. 

From this study, combined with experience running the CFL3D code for time-accurate 
cases, the following conclusions are made: 

1. In general, it is recommended that the user employ multigrid when using sub-itera- 
tions. 

2. The larger the time step (the less steps per period), the more sub-iterations are required 

to converge the sub-iterative scheme. 

3. The larger the grid, the more sub-iterations are required to converge the sub-iterative 

scheme. 

4. /-TS and x-TS are roughly equivalent in their ability to converge a quantity like 
“drag”. However, for lowering residual, /-TS is slightly more efficient than x-TS at 
small time steps, while the reverse is true at higher time steps. 

5. /-TS appears to require slightly less sub-iterations at low time steps, while x-TS 
appears to require slightly less sub-iterations at higher time steps. 

6. Since it is not possible to know in advance what time step is “low” and what is “high” 

(in connection with conclusions 4. and 5.) and since /-TS has been known to not con- 
verge regardless of the number of sub-iterations for some cases when the time step is 
too high, it is recommended that x -TS (with multigrid) be used in practice as a general 
rule. 

Also, the following recommendation is made. When performing time-accurate compu- 
tations, always monitor the cf 13d. subit_res file (unit 23) in order to insure that the sub- 
iterative scheme is converging sufficiently. Additionally, it is recommended that the user 
perform a time step study (vary dt), along with the usual grid density study, to determine 
the solution’s sensitivity to time step. 
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8.3 Convergence Criterion for Sub-iterations 



dQ n 

dt 


R (Q m )-R SU bit(Q m ) 


(8-4) 


where = R(Q m ) 
dt 


=> discrete Navier-Stokes equations . Therefore, to insure that the 


discrete Navier-Stokes equations are solved accurately, R subit (Q m ) « /?(Q m ) are needed. 

These values are calculated in the code. R subit { Q m ) (for Q = density) is output to 

cfl3d_subit .res, while R( Q m ) (for Q = density) is output to the user-specified file on 
unit 12 (typically called cfl3d.res in the sample input files). 
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CHAPTER 9 


Test Cases 



CFL3D provides multiple options for solving CFD problems. A variety of 0-equation, 
1 -equation, and 2-equation turbulence models are available. The code has static or 
dynamic mesh capabilities. If the grid has multiple zones, there are several choices for 
communication between the zones which can be used independently or in conjunction 
with one another. For convergence acceleration, multigrid and mesh sequencing are avail- 
able. 

The test cases described in this chapter provide a sampling of CFL3D’s capabilities. 
After studying the test cases, the user will hopefully be able to choose the best strategy for 
his or her particular applications. For information on how to obtain the files needed for the 
test cases see “Acquiring the Code and Example Files” on page 7. 

Several two-dimensional test cases discussed in this chapter involve airfoils and flat 
plates. The use of a single block is exemplified with a RAE 2822 airfoil case. A NACA 
0012 airfoil case is used as an example for both grid patching and grid overlapping. Also 
included is a multielement airfoil case, involving grid overlapping. The flat plate examples 
include a turbulent flat plate case and a vibrating flat plate case which illustrates the 
dynamic mesh capabilities of CFL3D. Also included are a multistream nozzle case and a 
rotor- stator case. 

One three-dimensional example is for an axisymmetric bump. By taking advantage of 
periodicity, it is solved on a grid with only two planes in the circumferential direction. 
Three of the three-dimensional examples are for wing topologies. A single block case is 
set up for an F-5 wing. A case solving for the viscous flow over the Onera M-6 wing is 
also set up using a single block. A delta wing case with laminar flow is also available. 
Keep in mind that, in order to have cases that are “quick” to run, the three-dimensional 
grids used in some of these examples are relatively coarse compared to what one should 
use to adequately resolve the flow. 

Note: you may see slight differences in your results, due to errors in CFL3D that have 
been corrected since the plots in this chapter were generated. 


9. 1 Two-dimensional Test Cases 

CFL3D solves for the primitive variables at the cell centers of a grid. Therefore, for 
two-dimensional cases, two grid planes are needed for one plane of cell-center points to 
exist. The “2-d direction” is the i direction designated by setting idim = 2 (and i2d = 1). 
Typically, after a 2-d grid is generated, it is simply duplicated such that identical planes 
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exist at i = 1 and i = 2 with a constant value in the third direction. For example, if x is the 
third direction, x is typically set to 0.0 at i = 1 and x might equal 1 .0 or -1 .0 at i = 2. 
When setting up the third direction by duplicating the grid plane, keep in mind that the 
right-hand rule must be satisfied. See “The Right-Hand Rule” on page 67. Also note that, 
while this step is doubling the number of grid points, only one plane of data is actually 
computed. Therefore, the number of points in one plane of the grid should be used when 
estimating the time required to run the code. 

9.1.1 RAE 2822 Airfoil 

This test case solves for the viscous flow over the RAE 2822 airfoil at oc = 2.72° with 
= 0.75. These are corrected conditions from Case 10 of Cook et al. 15 The grid consists 

of a single zone with 24929 points in one plane. Menter’s k — CO SST model is used to 
solve the turbulent flow with a Reynolds number of 6.2 million. The memory requirement 
for this example is 5.7 million words. A typical timing for this case is 382 CPU seconds on 
a CRAY YMP (NASA LaRC’s Sabre as of June 1996). A close-up of the grid near the air- 
foil is shown in Figure 9-1. 



MiSKISI 


warn 


Figure 9-1. Single zone RAE 2822 airfoil grid. 
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9.1.1 RAE 2822 Airfoil 

Besides the CFL3D code, the following files are needed to run this test case: 

File Description 

raelO . inp input for CFL3D 

raelO . grd formatted single plane grid 

grid2dto3d . f converter for creating 2 grid planes 

The steps for running this case on the YMP are as follows: 

Step l 

Compile the grid converter code: 

cft77 grid2dto3d.f 

Step 2 

Link the grid converter object file: 

segldr -o grid2dto3d grid2dto3d.o 

Step 3 

Run the grid converter program (the binary file raelO . bin will be output): 

grid2dto3d 

In answer to the questions, type: 

raelO . grd 
raelO . bin 
2 
0 

Step 4 

Use the makefile to compile, link, and create the executable for the precfl3d code (be 
sure precf l .h is in the current directory): 

make -f makeprecf 13d_cray 

Step 5 

Run the precf 13d code (the cflx.h files will be output): 

precf 13d < raelO. inp 

Step 6 

Use the makefile to compile, fink, and create the executable for the CFL3D code: 
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make -f makecf 13d_cray 

Step 7 


Run the CFL3D code: 

cfl3d < raelO.inp 

The input file for this case is: 

FILES: 
raelO . bin 
plot3dg . bin 
plot3dq . bin 
c f 13d . out 
c f 13d . res 
c f 13d . turres 
cf 13d . blomax 
cfl3d.outl5 
cf 13d.prout 
cf 13d.out20 
ovrlp . bin 
patch . bin 
restart . bin 


RAE case 10, with 

SST model 


XMACH 

ALPHA 

BETA 

REUE, MIL 

0.7500 

02.720 

0.0 

6.2000 

SREF 

CREF 

BREF 

XMC 

1.00000 

1.00000 

1.0000 

0.00000 

DT 

IREST 

IFLAGTS 

FMAX 

-5.0000 

0 

000 

05.0000 

NGRID 

NPLOT3D 

NPRINT 

NWREST 

1 

1 

1 

6100 

NCG 

I EM 

I ADVANCE 

IFORCE 

2 

0 

0 

1 

IDIM 

JDIM 

KDIM 


2 

257 

97 


ILAMLO 

ILAMHI 

JLAMLO 

JLAMHI 

1 

2 

88 

159 

INEWG 

IGRIDC 

IS 

JS 

0 

0 

0 

0 

IDIAG(I) 

IDIAG(J) 

IDIAG(K) 

IFLIM(I) 

1 

1 

1 

3 

IFDS (I) 

IFDS(J) 

IFDS (K) 

RKAP0 { I ) 

1 

1 

1 

0.3333 

GRID 

NBC 10 

NBCIDIM 

NBCJ0 

1 

1 

1 

1 

10: GRID 

SEGMENT 

BCTYPE 

JSTA 

1 

1 

1001 

0 

IDIM: GRID 

SEGMENT 

BCTYPE 

JSTA 

1 

1 

1002 

0 

JO: GRID 

SEGMENT 

BCTYPE 

ISTA 

1 

1 

1002 

0 

JDIM: GRID 

SEGMENT 

BCTYPE 

ISTA 

1 

1 

1002 

0 

K0: GRID 

SEGMENT 

BCTYPE 

ISTA 

1 

1 

0 

0 

1 

2 

2004 

0 


TWTYPE 

CQ 



0 . 

0 . 


1 

3 

0 

0 

KDIM : GRID 

SEGMENT 

BCTYPE 

ISTA 

1 

1 

1003 

0 

MSEQ 

MG FLAG 

ICONSF 

MTT 

1 

1 

0 

0 

ISSC 

EPSSSC(i) 

EPSSSC { 2 ) 

EPSSSC (3) 

0 

0.3 

0.3 

0.3 

NCYC 

MGLEVG 

NEMGL 

NITFO 


TINF , DR 

IALPH 

IHSTRY 


460.0 

0 

0 


YMC 

ZMC 



0.00 

0.00 



IUNST 

CFLTAU 



0 

10.0 



ICHK 

I2D 

NTSTEP 

ITA 

0 

1 

0001 

1 

IVISC < I) 

IVISC {J> 

IVISC (K) 


0 

0 

7 



KLAMLO 

KLAMHI 



1 

97 



KS 

IE 

JE 

KE 

0 

0 

0 

0 

IFLIM { J ) 

IFLIM ( K) 



3 

3 



RKAP0 ( J) 

RKAP0 (K) 



0.3333 

0.3333 



NBCJDIM 

NBCK0 

NBCKDIM 

I OVRLP 

1 

3 

1 

0 

JEND 

KSTA 

KEND 

NDATA 

0 

0 

0 

0 

JEND 

KSTA 

KEND 

NDATA 

0 

0 

0 

0 

I END 

KSTA 

KEND 

NDATA 

0 

0 

0 

0 

I END 

KSTA 

KEND 

NDATA 

0 

0 

0 

0 

I END 

JSTA 

JEND 

NDATA 

0 

1 

41 

0 

0 

41 

217 

2 


0 

217 

257 

0 

I END 

JSTA 

JEND 

NDATA 

0 

0 

0 

0 

NGAM 

02 

ISSR 

EPSSSR(l) 

EPSSSR ( 2 ) 

EPSSSR { 3 ) 

0 

0.3 

0.3 

0.3 
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9.1.1 RAE 2622 Airfoil 


500 03 00 000 

MIT1 MIT2 MIT3 MIT4 MIT5 MIT6 MIT7 MIT8 

01 01 01 01 01 1 11 

1-1 BLOCKING DATA: 

NBLI 

1 

NUMBER GRID : ISTA JSTA KSTA I END JEND KEND ISVA1 ISVA2 

I 1 1112 41 112 

NUMBER GRID : ISTA JSTA KSTA I END JEND KEND ISVA1 ISVA2 

II 1 257 1 2 217 1 1 2 

PATCH SURFACE DATA: 

NINTER 

0 

PLOT3D OUTPUT: 

GRID IPTYPE ISTART I END IINC JSTART JEND JINC KSTART KEND KINC 

1 0 1 01 1 01 999 1 1 999 1 

MOVIE 
0 

PRINT OUT: 

GRID IPTYPE ISTART I END IINC JSTART JEND JINC KSTART KEND KINC 

1 0 1 01 1 41 217 1111 

CONTROL SURFACE: 

NCS 

0 

GRID ISTART I END JSTART JEND KSTART KEND IWALL INORM 

After running this test case a result such as that shown in Figure 9-2 should be 
obtained. In the figure, surface pressure coefficients are plotted along with experimental 
data for this case. The computational surface pressures can be obtained from file 
cf 13d . prout. Experimental surface pressure coefficients from Cook et. al 15 are included 
with this test case for comparison purposes. The file is called raeio .cpexp. The residual 
plots shown in Figure 9-3 should also be duplicated. These convergence histories can be 
found in cfl3d. res. 



Figure 9 - 2 . Surface pressure coefficients for RAE 2822 airfoil; 
a = 2.72° , = 0.75, Re } = 6.2 x 10 6 . 

L R 


CFL3D User's Manual 155 


CHAPTER 9 Test Cases 



cycles 

a) residual history 



cycles 

c) drag coefficient history 



cycles 

b) lift coefficient history 



cycles 

d) moment coefficient history 


Figure 9-3. Residual and coefficient histories for RAE 2822 airfoil case, 
a = 2.72° , = 0.75, Re-. = 6.2 x 10 6 
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9.1.2 NACA 0012 Airfoil with Overlapped Grids 


9.1.2 NACA 0012 Airfoil with Overlapped Grids 

This test case solves for the inviscid flow over the NACA 0012 airfoil at a = 5° with 
M „ = 0.2. The grid has a total of 4850 points on two grid zones which communicate with 

one another through overlapped grid stencils. Therefore, the MaGGiE code is used in 
addition to CFL3D. The memory requirement for this case is 1.8 million words. A typical 
timing for this case is 43 CPU seconds on a CRAY YMP (NASA LaRC’s Sabre as of June 
1996). A close-up of the grid near the airfoil is shown in Figure 9-4. 


1.0 
0.5 
0.0 
- 0.5 
- 1.0 

0 1 2 

Figure 9-4. Two-zone overlapped grid system for NACA 0012 airfoil. 

Besides the CFL3D and MaGGiE codes the following files are needed to run this test 
case: 

File 

0 012x . inp 
0012x . fmt 
fmttobin_p3d . f 
magi .h 
maggie . inp 

The steps for running this case on the YMP are as follows: 


Description 
input for CFL3D 

formatted grid in PLOT3D format 
grid converter 

parameters for MaGGiE makefile 
input for MaGGiE 
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CHAPTER 9 Test Cases 

Step l 

Compile the grid converter code: 

cft77 fmttobin_p3d . f 

Step 2 

Link the grid converter object file: 

segldr -o fmttobin_p3d fmttobin_jp3d . o 

Step 3 

Run the grid converter program (the binary file ooi2x.bin will be output): 

fmttobin_p3d 

Step 4 

Use the makefile to compile, link, and create the executable for the MaGGiE code (be sure 
magi .h is in the current directory): 

make -f makemaggie_cray 

Step 5 

Run the MaGGiE code (the file ovrlp.bin will be output): 

maggie < maggie.inp 

Step 6 

Use the makefile to compile, link, and create the executable for the precfl3d code (be 
sure precfl .h is in the current directory): 

make -f makeprecf 13d_cray 

Step 7 

Run the precfl3d code (the cflx.h files will be output): 

precfl3d < 0012x.inp 

Step 8 

Use the makefile to compile, link, and create the executable for the CFL3D code: 

make -f makecf 13d_cray 

Step 9 

Run the CFL3D code: 
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9.1.2 NACA 0012 Airfoil with Overlapped Grids 


cf!3d < 0012x.inp 


The input file for this case is: 

I/O FILES 
0012x . bin 
plot3dg , bin 
plot3dq.bin 
cf 13d . out 
cfl3d.res 
cf 13d . turres 
cf 13d . blomax 
cf 13d. outlS 
cf 13d.prout 
cf 13d . out 20 
ovrlp . bin 
patch . bin 
restart . bin 

2-block 0012 airfoil as simple chimera test 



XMACH 

ALPHA 

BETA 

REUE.MIL 

TINF.DR 

IALPH 

IHSTRY 



.200 

5.000 

0.0 

0.0 

520.0 

1 

0 



SREF 

CREF 

BREF 

XMC 

YMC 

ZMC 



1 

. 00000 

1.00000 

1.0000 

0.25000 

0.00 

0.00 




DT 

IREST 

IFLAGTS 

FMAX 

IUNST 

CFLTAU 




-5.00 

0 

000 

1.00 

0 

10. 




NGRID 

NPLOT3D 

NPRINT 

NWREST 

ICHK 

I2D 

NTSTEP 

ITA 


-2 

2 

0 

100 

0 

1 

1 

1 


NCG 

I EM 

I ADVANCE 

IFORCE 

IVISC(I) 

IVISC(J) 

I VI SC ( K) 



2 

0 

0 

0 

0 

0 

0 



2 

0 

0 

1 

0 

0 

0 



IDIM 

JDIM 

KDIM 







002 

65 

25 







002 

129 

25 






ILAMLO 

ILAMHI 

JLAMLO 

JLAMHI 

KLAMLO 

KLAMHI 




00 

00 

000 

000 

0 

0000 




00 

00 

000 

000 

0 

0000 




INEWG 

IGRIDC 

IS 

JS 

KS 

IE 

JE 

KE 


0 

0 

0 

0 

0 

0 

0 

0 


0 

0 

0 

0 

0 

0 

0 

0 

IDIAG(I) 

IDIAG ( J ) 

IDIAG (K) 

IFLIM(I) 

IFLIM(J) 

IFLIM(K) 




1 

1 

1 

0 

0 

0 




1 

1 

1 

0 

0 

0 



IFDS(I) 

IFDS(J) 

IFDS(K) 

RKAP0 (I) 

RKAP0 ( J) 

RKAP0 ( K) 




1 

1 

1 

.3333 

.3333 

.3333 




1 

1 

1 

.3333 

.3333 

.3333 




GRID 

NBC 10 

NBCIDIM 

NBC JO 

NBCJDIM 

NBCK0 

NBCKDIM 

IOVRLP 


1 

1 

1 

1 

1 

1 

1 

1 


2 

1 

1 

1 

1 

1 

1 

1 

10 : 

GRID 

SEGMENT 

BCTYPE 

JSTA 

JEND 

KSTA 

KEND 

NDATA 


1 

1 

1002 

0 

0 

0 

0 

0 


2 

1 

1002 

0 

0 

0 

0 

0 

IDIM 

: GRID 

SEGMENT 

BCTYPE 

JSTA 

JEND 

KSTA 

KEND 

NDATA 


1 

1 

1002 

0 

0 

0 

0 

0 


2 

1 

1002 

0 

0 

0 

0 

0 

JO : 

GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

KSTA 

KEND 

NDATA 


1 

1 

0 

0 

0 

0 

0 

0 


2 

1 

0 

0 

0 

0 

0 

0 

JDIM 

: GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

KSTA 

KEND 

NDATA 


1 

1 

0 

0 

0 

0 

0 

0 


2 

1 

0 

0 

0 

0 

0 

0 

K0: 

GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

JSTA 

JEND 

NDATA 


1 

1 

0 

0 

0 

0 

0 

0 


2 

1 

1005 

0 

0 

0 

0 

0 

KDIM 

: GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

JSTA 

JEND 

NDATA 


1 

1 

1003 

0 

0 

0 

0 

0 


2 

1 

0 

0 

0 

0 

0 

0 


MSEQ 

MG FLAG 

ICONSF 

MTT 

NGAM 





1 

1 

1 

0 

01 





ISSC 

EPSSC(l) 

EPSSC (2) 

EPSSC (3) 

ISSR 

EPSSR(l) 

EPSSR ( 2 ) 

EPSSR ( 3 ) 


0 

.3 

.3 

.3 

0 

.3 

.3 

.3 
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NEMGL NITFO 

00 000 

MIT3 MIT4 MIT5 

01 01 01 


ISTA JSTA KSTA I END JEND KEND ISVAl ISVA2 

11121 25 13 

11121 25 13 

ISTA JSTA KSTA I END JEND KEND ISVAl ISVA2 

1 65 1 2 65 25 1 3 

1 129 1 2 129 25 1 3 


I END I INC J START JEND JINC KSTART KEND KINC 

001 1 01 999 1 1 999 1 

001 1 01 999 1 1 999 1 


I END I INC JSTART JEND JINC KSTART KEND KINC 


J START JEND KSTART KEND IWALL INORM 


The residual and coefficient histories for this case are plotted in Figure 9-5. 



I I 


NCYC MGLEVG 
500 03 

MIT1 MIT2 

01 01 
1-1 BLOCKING DATA: 
NBLI 
2 

NUMBER GRID : 

1 1 

2 2 

NUMBER GRID : 

1 1 

2 2 

PATCH SURFACE DATA: 
NINTER 
0 

PLOT3D OUTPUT: 

GRID IPTYPE 1ST ART 
10 1 
2 0 1 

MOVIE 
0 

PRINT OUT: 

GRID IPTYPE ISTART 
CONTROL SURFACE: 

NCS 

0 

GRID ISTART I END 
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9.1.2 NACA 0012 Airfoil with Overlapped Grids 



cycles 

a) residual history 



cycles 

b) lift coefficient history 



cycles cycles 

c) drag coefficient history d) moment coefficient history 

Figure 9-5. NACA 0012 with overlapped grids residual and coefficient histories; 

a = 5 ° = 0.2. 
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9.1.3 NACA 0012 Airfoil with Patched Grids 

This test case solves for the inviscid flow over the NACA 0012 airfoil at a = 1.25° 
with M x =0.8. The grid has a total of 4949 points in seven zones which communicate 

with one another utilizing the patching option. Therefore, the ronnie code is used in addi- 
tion to CFL3D. An advantage of using patched grids is that finer grids can be placed in 
high gradient regions while relatively coarser grids can be placed elsewhere thus reducing 
the CPU time and memory needed. In this case, the finest grids are located in the regions 
where the upper and lower shocks are expected to occur in order to better resolve these 
flow phenomena. The memory requirement for this example is 1.9 million words. A typi- 
cal timing is 87 CPU seconds on a CRAY YMP (NASA LaRC’s Sabre as of June 1996). A 
close-up of the grid near the airfoil is shown in Figure 9-6. In the figure, the grids are 
labelled one through seven and this is the grid order in which the information is set up in 
the input file. 



Figure 9-6. Seven-zone patched grid system for NACA 0012 airfoil. 

Besides the CFL3D and ronnie codes the following files are needed to run this test 
case: 


File 

0012 . inp 
0012 . fmt 
fmttobin 


Description 
input for CFL3D 
formatted grid 
grid converter 
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9.1.3 NACA 0012 Airfoil with Patched Grids 


File Description 

ronl • h parameters for ronnie makefile 

ronni e . inp input for ronnie 

The steps for running this case on the YMP are as follows: 

Step l 

Compile the grid converter code: 

cft77 fmttobin. f 

Step 2 

Link the grid converter object file: 

segldr -o fmttobin fmttobin. o 

Step 3 

Run the grid converter program (the binary file ooi2.bin will be output): 

fmttobin 

Step 4 

Use the makefile to compile, link, and create the executable for the ronnie code (be sure 
ronl .h is in the current directory): 

make -f makeronnie_cray 

Step 5 

Run the ronnie code (the file patch. bin_ooi2 will be output): 

ronnie < ronnie. inp 

Step 6. 

Use the makefile to compile, link, and create the executable for the precfl3d code (be 
sure precf l . h is in the current directory): 

make -f makeprecf 13d_cray 

Step 7 

Run the precf 13d code (the cflx.h files will be output): 

precf 13d < 0012. inp 
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Use the makefile to compile, link, and create the executable for the CFL3D code: 


make -f makecf 13d_cray 


Step 9 

Run the CFL3D code: 


cf 13d < 0012. inp 


The input file for this case is: 


I/O FILES 
0012 . bin 
plot3dg.bin 
plot3dq.bin 
cf 13d. out 
cf 13d. res 
cf 13d. turres 
cf 13d,blomax 
cf 13d. out!5 
cf 13d.prout 
cf 13d. out20 
ovrlp . bin 
patch . bin_00 12 
restart.bin 

input for 7 block patched 0012 


XMACH 

0.80 

SREF 

.00000 

DT 

- 5.00 

NGRID 

7 

NCG 

1 

1 

1 

1 

1 

1 

1 

IDIM 

2 

2 

2 

2 

2 

2 

2 

ILAMLO 

00 

00 

00 

00 

00 

00 

00 

INEWG 

0 

0 

0 

0 

0 


ALPHA 

1.25 

CREF 

1.00000 

IREST 

0 

NPLOT3D 

7 


0 

0 

0 

0 

0 

0 

0 

JDIM 

65 

23 

79 

15 

17 

13 

9 

ILAMHI 

00 

00 

00 

00 

00 

00 

00 

IGRIDC 

0 

0 

0 

0 

0 


grids - iopt = 1 in assemble. f 


,PHA BETA 

25 0.0 

REF BREF 

000 1.0000 

,EST IFLAGTS 

0 000 

iT3D nprint 

7 0 

I EM I ADVANCE 

0 0 


0 

0 

0 

0 

0 

0 

KDIM 

13 

25 

25 

25 

25 

49 

13 

JLAMLO 

000 


REUE, MIL 
0.000 
XMC 
0.25000 
FMAX 
1.00 
NWREST 
100 


T INF, DR 
122.0 
YMC 
0.00 
IUNST 
0 

ICHK 

0 


IFORCE IVISC(I) 


JLAMHI 

000 

000 

000 

000 

000 

000 

000 

JS 

0 

0 

0 

0 

0 


IALPH 

0 

ZMC 

0.00 

CFLTAU 

10.0 

I2D 

1 

IVISC(J) 

0 

0 

0 

0 

0 

0 

0 


KLAMLO 

0 

0 

0 

0 

0 

0 

0 

KS 

0 

0 

0 

0 

0 


KLAMHI 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

IE 

0 

0 

0 

0 

0 


IHSTRY 

0 


NTSTEP 

1 

IVISC (K) 
0 
0 
0 
0 
0 
0 
0 
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9.1.3 

NACA 0012 Airfoil with Patched Grids 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

IDIAG(I) 

IDIAG(J) 

IDIAG(K) 

IFLIM { I ) 

IFLIM ( J) 

IFLIM (K) 



0 

0 

0 

3 

3 

3 



0 

0 

0 

3 

3 

3 



0 

0 

0 

3 

3 

3 



0 

0 

0 

3 

3 

3 



0 

0 

0 

3 

3 

3 



0 

0 

0 

3 

3 

3 



0 

0 

0 

3 

3 

3 



IFDS(I) 

IFDS(J) 

IFDS ( K} 

RKAPO (I) 

RKAPO (J) 

RKAPO (K) 



0 

0 

0 

.3333 

.3333 

.3333 



0 

0 

0 

.3333 

.3333 

.3333 



0 

0 

0 

.3333 

.3333 

.3333 



0 

0 

0 

.3333 

.3333 

.3333 



0 

0 

0 

.3333 

.3333 

.3333 



0 

0 

0 

.3333 

.3333 

.3333 



0 

0 

0 

. 3333 

.3333 

.3333 



GRID 

NBC 10 

NBC I DIM 

NBC JO 

NBCJDIM 

NBCKO 

NBC KDIM 

IOVRLP 

1 

1 

1 

1 

1 

1 

1 

0 

2 

1 

1 

1 

1 

1 

1 

0 

3 

1 

1 

1 

1 

1 

1 

0 

4 

1 

1 

1 

1 

1 

1 

0 

5 

1 

1 

1 

1 

1 

1 

0 

6 

1 

1 

1 

1 

1 

1 

0 

7 

1 

1 

1 

1 

1 

1 

0 

10: GRID 

SEGMENT 

BCTYPE 

JSTA 

JEND 

KSTA 

KEND 

NDATA 

1 

1 

1002 

0 

0 

0 

0 

0 

2 

1 

1002 

0 

0 

0 

0 

0 

3 

1 

1002 

0 

0 

0 

0 

0 

4 

1 

1002 

0 

0 

0 

0 

0 

5 

1 

1002 

0 

0 

0 

0 

0 

6 

1 

1002 

0 

0 

0 

0 

0 

7 

1 

1002 

0 

0 

0 

0 

0 

I DIM: GRID 

SEGMENT 

BCTYPE 

JSTA 

JEND 

KSTA 

KEND 

NDATA 

1 

1 

1002 

0 

0 

0 

0 

0 

2 

1 

1002 

0 

0 

0 

0 

0 

3 

1 

1002 

0 

0 

0 

0 

0 

4 

1 

1002 

0 

0 

0 

0 

0 

5 

1 

1002 

0 

0 

0 

0 

0 

6 

1 

1002 

0 

0 

0 

0 

0 

7 

1 

1002 

0 

0 

0 

0 

0 

JO : GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

KSTA 

KEND 

NDATA 

1 

1 

0 

0 

0 

0 

0 

0 

2 

1 

0 

0 

0 

0 

0 

0 

3 

1 

0 

0 

0 

0 

0 

0 

4 

1 

0 

0 

0 

0 

0 

0 

5 

1 

0 

0 

0 

0 

0 

0 

6 

1 

0 

0 

0 

0 

0 

0 

7 

1 

0 

0 

0 

0 

0 

0 

JDIM: GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

KSTA 

KEND 

NDATA 

1 

1 

0 

0 

0 

0 

0 

0 

2 

1 

0 

0 

0 

0 

0 

0 

3 

1 

0 

0 

0 

0 

0 

0 

4 

1 

0 

0 

0 

0 

0 

0 

5 

1 

0 

0 

0 

0 

0 

0 

6 

1 

0 

0 

0 

0 

0 

0 

7 

1 

0 

0 

0 

0 

0 

0 

KO : GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

JSTA 

JEND 

NDATA 

1 

1 

0 

0 

0 

0 

0 

0 

2 

1 

1005 

0 

0 

0 

0 

0 

3 

1 

1005 

0 

0 

0 

0 

0 

4 

1 

1005 

0 

0 

0 

0 

0 

5 

1 

1005 

0 

0 

0 

0 

0 

6 

1 

1005 

0 

0 

0 

0 

0 

7 

1 

0 

0 

0 

0 

0 

0 

KDIM: GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

JSTA 

JEND 

NDATA 

1 

1 

1003 

0 

0 

0 

0 

0 

2 

1 

0 

0 

0 

0 

0 

0 

3 

1 

0 

0 

0 

0 

0 

0 

4 

1 

0 

0 

0 

0 

0 

0 

5 

1 

0 

0 

0 

0 

0 

0 
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6 


1 

0 


0 

0 


0 

0 

0 

7 


1 

0 


0 

0 


0 

0 

0 

MSEQ 

MGFLAG 

ICONSF 


MTT 

NGAM 





2 


1 

1 


0 

02 





ISSC 

EPSSC (1) 

EPSSC (2) 

EPSSC (3) 

ISSR 

EPSSR(l) E 

PSSR ( 2 ) 

EPSSR ( 3 ) 

0 


.3 

.3 


.3 

0 


.3 

.3 

.3 

NCYC 

MGLEVG 

NEMGL 

NITFO 






0300 


01 

00 


000 






0300 


02 

00 


000 






MITl 


MIT2 

MIT3 


MIT4 

MIT 5 





01 


01 

01 


01 

01 





01 


01 

01 


01 

01 





1-1 BLOCKING 

DATA: 








1 

NBLI 











X 

NUMBER GRID 


ISTA 

JSTA 

KSTA 

I END 

JEND 

KEND 

ISVA1 

ISVA2 

1 

1 


1 

1 

1 

2 

1 

13 

1 

3 j 

NUMBER GRID 


ISTA 

JSTA 

KSTA 

I END 

JEND 

KEND 

ISVAl 

ISVA2 

1 

1 


1 

65 

1 

2 

65 

13 

1 

3 ! 

PATCH SURFACE 

DATA: 








j 

NINTER 










! 

- X 

PLOT3D OUTPUT 

: 








j 

GRID IPTYPE 

ISTART 

I END 

I INC 

JSTART 

JEND 

JINC 

KSTART 

KEND 

KINC 

1 

0 

1 

001 

1 

01 

999 

1 

1 

999 

1 

2 

0 

1 

001 

1 

01 

999 

1 

1 

999 

1 

3 

0 

1 

001 

1 

01 

999 

1 

1 

999 

1 

4 

0 

1 

001 

1 

01 

999 

1 

1 

999 

1 

5 

0 

1 

001 

1 

01 

999 

1 

1 

999 

l s 

6 

0 

1 

001 

1 

01 

999 

1 

1 

999 

1 1 

7 

0 

1 

001 

1 

01 

999 

1 

1 

999 

1 ! 

MOVIE 

n 










| 

u 

PRINT OUT 










s 

GRID IPTYPE 

ISTART 

TEND 

I INC 

JSTART 

JEND 

JINC 

KSTART 

KEND 

KINC ! 


CONTROL SURFACE: 

NCS 

0 

GRID ISTART TEND JSTART JEND KSTART KEND IWALL INOEM 


The residual and force coefficient history plots for this case is shown in Figure 9-7. 
The sharp spike in the residual history plot depicts the iteration at which the grid levels 
changed for mesh sequencing. These convergence histories can be found in cf 13d . res. 
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CHAPTER 9 


Test Cases 


9.1.4 Multielement Airfoil with Overlapped Grids 

This test case solves for the viscous, turbulent flow over a three-element airfoil with 
M = 0.2, a = 8.109° , and a Reynolds number of 9 million. The Spalart-Allmaras tur- 
bulence model is used. The grid, with a total of 59051 points, consists of three zones, one 
for each element. The grid zones communicate with one another utilizing the grid overlap- 
ping option. Therefore, the MaGGiE code is used in addition to CFL3D. The memory 
requirement for this case is 9.5 million words. A typical timing is 2849 CPU seconds on a 
CRAY YMP (NASA LaRC’s Sabre as of June 1996). A close-up of the grid near the air- 
foil is shown in Figure 9-8. In the figure, the grids are labelled one through three and this 
is the grid order in which the information is set up in the input file. 


0.6 
0.4 
0.2 
0.0 
- 0.2 

0.0 0.5 

Figure 9-8. Three-zone overlapped grid system for a three-element airfoil. 

Besides the CFL3D and MaGGiE codes the following files are needed to run this test 
case: 

File 

multi . inp 
grid . fmt 
fmttobin. f 
magi . h 

mag . inp_multi 


Description 
input for CFL3D 
formatted grid 
grid converter 

parameters for MaGGiE makefile 
input for MaGGiE 
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The steps for running this case on the YMP are as follows: 

Step 1 

Compile the grid converter code: 

<zix.ll fmttobin.f 

Step 2 

Link the grid converter object file: 

segldr -o fmttobin fmttobin.o 

Step 3 

Run the grid converter program (the binary file muiti.bin will be output): 

fmttobin 

Step 4 

Use the makefile to compile, link, and create the executable for the MaGGiE code (be sure 
magi .h is in the current directory): 

make -f makemaggie_cray 

Step 5 

Run the MaGGiE code (the file ovrip . bin will be output): 

maggie < mag . inp_mul t i 

Step 6 

Use the makefile to compile, link, and create the executable for the precfl3d code (be 
sure precf 1 .h is in the current directory): 

make -f makeprecf 13d_cray 

Step 7 

Run the precf 13d code (the cflx.h files will be output): 

precf 13d < multi. inp 

Step 8 

Use the makefile to compile, link, and create the executable for the CFL3D code: 

make -f makecf 13d_cray 
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Step 9 

Run the CFL3D code: 

cfl3d < multi. inp 


The input file for this case is: 

I/O FILES 
multi . bin 
plot 3dg . bin 
plot3dq.bin 
cf 13d . out 
cf 13d. res 
cf 13d. turres 
cf 13d.blomax 
cf 13d. outlS 
cf 13d . prout 
cf 13d. out20 
ovrlp . bin 
patch . bin 
restart .bin 


3 element 

airfoil - 

chimera-i 

type grids 

- Spalart- 

-Allmaras turb model 


XMACH 

ALPHA 

BETA 

REUE , MIL 

T INF, DR 

IALPH 

IHSTRY 


.2000 

8.109 

0.0 

9.0 

520.0 

0 

0 


SREF 

CREF 

BREF 

XMC 

YMC 

ZMC 



1.00000 

1.00000 

1.0000 

0.25000 

0.00 

0 . 00 



DT 

IREST 

IFLAGTS 

FMAX 

IUNST 

CFLTAU 



-5.00 

0 

000 

1.00 

0 

10.0 



NGRID 

NPLOT3D 

NPRINT 

NWREST 

ICHK 

I2D 

NTSTEP 

ITA 

3 

3 

0 

100 

0 

1 

1 

1 

NCG 

I EM 

I ADVANCE 

IFORCE 

IVISC(I) 

I VI SC ( J) 

I VISC (K) 


2 

0 

0 

001 

0 

0 

5 


2 

0 

0 

001 

0 

0 

5 


2 

0 

0 

001 

0 

0 

5 


IDIM 

JDIM 

KDIM 






002 

361 

65 






002 

369 

57 






002 

297 

49 






ILAMLO 

ILAMHI 

JLAMLO 

JLAMHI 

KLAMLO 

KLAMHI 



00 

00 

000 

000 

0 

0000 



00 

00 

000 

000 

0 

0000 



00 

00 

000 

000 

0 

0000 



INEWG 

IGRIDC 

IS 

JS 

KS 

IE 

JE 

KE 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

IDIAG(I) 

IDIAG { J) 

IDIAG (K) 

IFLIM(I) 

IFLIM ( J ) 

IFLIM (K) 



1 

1 

1 

3 

3 

3 



1 

1 

1 

3 

3 

3 



1 

1 

1 

3 

3 

3 



IFDS(I) 

IFDS(J) 

IFDS(K) 

RKAP0 (I) 

RKAP0 (J) 

RKAP0 (K) 



1 

1 

1 

.3333 

.3333 

.3333 



1 

1 

1 

.3333 

.3333 

.3333 



1 

1 

1 

.3333 

.3333 

.3333 



GRID 

NBC 10 

NBCIDIM 

NBC JO 

NBCJDIM 

NBCK0 

NBCKDIM 

I OVRLP 

1 

1 

1 

1 

1 

3 

1 

1 

2 

1 

1 

1 

1 

3 

1 

1 

3 

1 

1 

1 

1 

3 

1 

1 

10: GRID 

SEGMENT 

BCTYPE 

JSTA 

JEND 

KSTA 

KEND 

NDATA 

1 

1 

1002 

0 

0 

0 

0 

0 

2 

1 

1002 

0 

0 

0 

0 

0 

3 

1 

1002 

0 

0 

0 

0 

0 

IDIM: GRID 

SEGMENT 

BCTYPE 

JSTA 

JEND 

KSTA 

KEND 

NDATA 

1 

1 

1002 

0 

0 

0 

0 

0 

2 

1 

1002 

0 

0 

0 

0 

0 

3 

1 

1002 

0 

0 

0 

0 

0 

JO: GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

KSTA 

KEND 

NDATA 

1 

1 

1003 

0 

0 

0 

0 

0 
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21000000 

31000000 


JDIM : GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

KSTA 

KEND 

NDATA 

1 

1 

1003 

0 

0 

0 

0 

0 

2 

1 

0 

0 

0 

0 

0 

0 

3 

1 

0 

0 

0 

0 

0 

0 

K0 : GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

JSTA 

JEND 

NDATA 

1 

1 

0 

0 

0 

1 

73 

0 

1 

2 

2004 

0 

0 

73 

289 

2 


TWTYPE 

CQ 







0. 

0. 






1 

3 

0 

0 

0 

289 

361 

0 

2 

1 

0 

0 

0 

1 

65 

0 

2 

2 

2004 

0 

0 

65 

305 

2 


TWTYPE 

CQ 







0. 

0. 






2 

3 

0 

0 

0 

305 

369 

0 

3 

1 

0 

0 

0 

1 

49 

0 

3 

2 

2004 

0 

0 

49 

249 

2 


TWTYPE 

CQ 







0. 

0. 






3 

3 

0 

0 

0 

249 

297 

0 

KDIM: GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

JSTA 

JEND 

NDATA 

1 

1 

1003 

0 

0 

0 

0 

0 

2 

1 

0 

0 

0 

0 

0 

0 

3 

1 

0 

0 

0 

0 

0 

0 

MSEQ 

MG FLAG 

ICONSF 

MTT 

NGAM 




1 

1 

1 

0 

01 




ISSC 

EPSSC(l) 

EPSSC ( 2 ) 

EPSSC (3 ) 

ISSR 

EPSSR(l) 

EPSSR (2 ) 

EPSSR ( 3 ) 

0 

.3 

.3 

.3 

0 

.3 

.3 

.3 

NCYC 

MGLEVG 

NEMGL 

NITFO 





2000 

03 

00 

000 





MIT1 

MIT2 

MIT3 

MIT4 

MIT5 




01 

01 

01 

01 

01 




1-1 BLOCKING DATA: 








NBLI 

3 


NUMBER 

GRID 


ISTA 

JSTA 

KSTA 

I END 

JEND 

KEND 

ISVAl 

ISVA2 

1 

1 


1 

1 

1 

2 

73 

1 

1 

2 

2 

2 


1 

1 

1 

2 

65 

1 

1 

2 

3 

3 


1 

1 

1 

2 

49 

1 

1 

2 

NUMBER 

GRID 


ISTA 

JSTA 

KSTA 

I END 

JEND 

KEND 

ISVAl 

ISVA2 

1 

1 


1 

361 

1 

2 

289 

1 

1 

2 

2 

2 


1 

369 

1 

2 

305 

1 

1 

2 

3 

3 


1 

297 

1 

2 

249 

1 

1 

2 

PATCH 

SURFACE 

DATA: 









NINTER 

0 

PLOT 3D OUTPUT 










GRID 

IPTYPE 

ISTART 

I END 

I INC 

JSTART 

JEND 

JINC 

KSTART 

KEND 

KINC 

1 

1 

1 

001 

1 

01 

999 

1 

1 

999 

1 

2 

1 

1 

001 

1 

01 

999 

1 

1 

999 

1 

3 

MOVIE 

0 

PRINT 

1 

1 

001 

1 

01 

999 

1 

1 

999 

1 

OUT: 










GRID 

IPTYPE 

ISTART 

I END 

IINC 

JSTART 

JEND 

JINC 

KSTART 

KEND 

KINC 


CONTROL SURFACE: 
NCS 


0 

GRID I START TEND JSTART JEND KSTART KEND IWALL INORM 

After running this test case, the residual and force coefficient convergence histories 
should look like those in Figure 9-9. These convergence histories can be found in file 
cf 13d. res. Note the unusually high number of multigrid cycles required to converge this 
case. While quite large, this is the behavior typically seen (with CFL3D) for multielement 
airfoil cases, even when one-to-one blocking is employed. 
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9.1.5 Flat Plate 

The viscous, turbulent flow with a Reynolds number of 6 million over a flat plate is 
solved in this test case. The grid consists of a single grid zone with 6305 points. Menter’s 
k - to SST turbulence model is utilized in this example. The memory requirement is 2.3 
million words. A typical timing for this case is 157 CPU seconds on a CRAY YMP 
(NASA LaRC’s Sabre as of June 1996). The entire flat plate grid is illustrated in Figure 9- 
10 . 



Figure 9-io. Single zone flat plate grid. 

Besides the CFL3D code the following files are needed to run this test case: 


File 

grdf lat5 . inp 
grdf lat 5 . grd 
grid2dto3d . f 


Description 
input for CFL3D 
formatted grid 
grid converter 


The steps for running this case on the YMP are as follows: 
Step l 

Compile the grid converter code: 

cft77 grid2dto3d.f 
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Step 2 

Link the grid converter object file: 

segldr -o grid2dto3d grid2dto3d.o 

Step 3 

Run the grid converter program (the binary file grdflats .bin will be output): 

grid2dto3d 

In answer to the questions, type: 

grdf lat5 . grd 
grdflat5 .bin 
2 
0 

Step 4 

Use the makefile to compile, link, and create the executable for the precfl3d code (be 
sure precf 1 . h is in the current directory): 

make -f makeprecf 13d_cray 

Step 5 

Run the precfl3d code (the cflx.h files will be output): 

precf 13d < grdflatS.inp 

Step 6 

Use the makefile to compile, link, and create the executable for the CFL3D code: 

make -f makecf 13d_cray 


Step 7 

Run the CFL3D code: 

cf!3d < grdflat5.inp 


The input file for this case is: 

I/O FILES 
grdf lat5 . bin 
plot3dg . bin 
plot3dq . bin 
cf 13d . out 
cfl3d.res 
cf 13d. curres 
cf 13d.blomax 
cf 13d. out 15 
cf 13d.prout 
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cfl3d.out20 
ovrlp . bin 
patch . bin 
restart .bin 

turbulent flat plate (plate from j=17-65, prior to 17 is symmetry) 


XMACH 

ALPHA 

BETA 

REUE , MIL 

TINF , DR 

IALPH 

IHSTRY 


0.2000 

00.000 

0.0 

06.000 

460.0 

0 

0 


SREF 

CREF 

BREF 

XMC 

YMC 

ZMC 



1.00000 

1.00000 

'1.0000 

0.00000 

0.00 

0.00 



DT 

IREST 

IFLAGTS 

FMAX 

IUNST 

CFLTAU 



-5 . 000 

1 

000 

05.0000 

0 

10. 



NGRID 

NPLOT3D 

NPRINT 

NWREST 

ICHK 

I2D 

NTSTEP 

ITA 

1 

1 

2 

1200 

0 

1 

1 

1 

NCG 

I EM 

I ADVANCE 

IFORCE 

IVISC (I) 

IVISC (J) 

IVISC (K) 


2 

0 

0 

001 

0 

0 

12 


I DIM 

JDIM KDIM 






02 

65 

97 






ILAMLO 

ILAMHI 

JLAMLO 

JLAMHI 

KLAMLO 

KLAMHI 



1 

2 

1 

17 

1 

97 



INEWG 

IGRIDC 

IS 

JS 

KS 

IE 

JE 

KE 

0 

0 

0 

0 

0 

0 

0 

0 

IDIAG ( I ) 

IDIAG (J) 

IDIAG (K) 

IFLIM(I) 

IFLIM ( J ) 

IFLIM (K) 



1 

1 

1 

0 

0 

0 



IFDS(I) 

IFDS (J) 

IFDS (K) 

RKAP0 (I) 

rkapo (j) 

RKAPO (K) 



1 

1 

1 

0.3333 

0.3333 

0.3333 



GRID 

NBCI0 

NBCIDIM 

NBC JO 

NBCJDIM 

NBCK0 

NBCKDIM 

IOVRLP 

1 

1 

1 

1 

1 

2 

1 

0 

10: GRID 

SEGMENT 

BCTYPE 

JSTA 

JEND 

KSTA 

KEND 

NDATA 

1 

1 

1001 

0 

0 

0 

0 

0 

IDIM: GRID 

SEGMENT 

BCTYPE 

JSTA 

JEND 

KSTA 

KEND 

NDATA 

1 

1 

1002 

0 

0 

0 

0 

0 

JO : GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

KSTA 

KEND 

NDATA 

1 

1 

1008 

0 

0 

0 

0 

0 

JDIM: GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

KSTA 

KEND 

NDATA 

1 

1 

1002 

0 

0 

0 

0 

0 

K0 : GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

JSTA 

JEND 

NDATA 

1 

1 

1001 

0 

0 

1 

17 

0 

1 

2 

2004 

0 

0 

17 

65 

2 


TWTYPE 

CQ 







0. 

0. 






KDIM: GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

JSTA 

JEND 

NDATA 

1 

1 

1003 

0 

0 

0 

0 

0 

MSEQ 

MGFLAG 

ICONSF 

MTT 

NGAM 




1 

1 

0 

0 

02 




ISSC 

EPSSSC ( 1 ) 

EPSSSC (2) 

EPSSSC (3) 

ISSR 

EPSSSR { 1 ) 

EPSSSR ( 2 ) 

EPSSSR ( 3 ) 

0 

0.3 

0.3 

0.3 

0 

0.3 

0.3 

0.3 

NCYC 

MGLEVG 

NEMGL 

NITFO 





0500 

03 

00 

000 





MIT1 

MIT2 

MIT3 

MIT4 

MIT5 

MIT6 

MIT7 

MIT8 

01 

01 

01 

01 

01 

1 

1 

1 


1-1 BLOCKING DATA: 
NBLI 


0 


NUMBER GRID : 

NUMBER GRID : 

PATCH SURFACE DATA: 
NINTER 
0 

PLOT 3D OUTPUT: 

ISTA 

ISTA 

JSTA 

JSTA 

KSTA 

KSTA 

I END 
I END 

JEND 

JEND 

KEND 

KEND 

ISVA1 

ISVA1 

ISVA2 

ISVA2 

GRID IPTYPE I START 
10 0 
IMOVIE 
0 

PRINT OUT: 

I END 
0 

I INC 
0 

J START 
0 

JEND 

0 

JINC 

0 

KSTART 

0 

KEND 

0 

KINC 

0 

GRID IPTYPE ISTART 

TEND 

I INC 

JSTART 

JEND 

JINC 

KSTART 

KEND 

KINC 


10 0 

0 

0 

0 

0 

0 

1 

1 

1 

10 0 

0 

0 

49 

49 

1 

0 

0 

0 

CONTROL SURFACE: 
NCS 









0 

GRID ISTART I END 

JSTART 

JEND 

KSTART 

KEND 

IWALL 

INORM 
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After this test case is run, the residual history, found in file cfi3d.res, should look 
like that plotted in Figure 9-11. In Figure 9-12, values of m + verses y + are plotted at two 
cross sections of the flat plate and compared with theoretical values. The u + and y + values 
were extracted from the PLOT3D grid and q files using a postprocessor currently not 
available for general use. 



Figure 9-n. Residual history for single grid flat plate case. 



Figure 9 - 12 . Flat plate calculation compared with experiment; R e~. - 6 x 10 . 


I 1 1 
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This flat plate case has been studied with all the turbulence models currently available 
in CFL3D and a summary of the timings is tabulated below: 


Turbulence Model 

ivisc 

Approximate 
CPU seconds 
per cycle 

Percent increase 
over Baldwin- 
Lomax per cycle 

Baldwin-Lomax 

2 

0.153 


Baldwin-Lomax with Degani-Schiff 

3 

0.153 

0 

Baldwin-Barth 

4 


16 

Spalart-Allmaras 

5 

0.182 

19 

Wilcox k - co 

6 

0.186 

22 

SST k - co 

7 

0.196 

28 

k - to EASM Gatski-Speziale (Linear) 

8 

0.218 

43 

k-e EASM Girimaji (Linear) 

9 

0.236 

54 

k-e (Abid version) 

10 

0.197 

29 

k-e EASM Gatski-Speziale (Nonlinear) 

11 

0.236 

54 

k - co EASM Gatski-Speziale (Nonlinear) 

12 

0.236 

54 

k-e EASM Girimaji (Nonlinear) 

13 

0.254 

66 


This case requires between 800 to 1800 cycles to converge, depending on the turbu- 
lence model employed and the convergence criterion chosen. Generally, k-e models 
take longer than k - to models and two-equation models tend to take longer than one- 
equation models. (See Appendix H.) Memory requirements also depend on which turbu- 
lence model is being used, varying from 2.2 to 2.4 million words. 

9.1.6 Vibrating Flat Plates 

This test case solves for the unsteady, time-accurate inviscid flow through an “infinite” 
row of vibrating flat plates. The plates, located from x = 0.0 to jc = 1 .0, are vibrating up 
and down with a sinusoidal motion. The maximum displacement is h = 0.001 and the 
nominal distance between the plates is 1.0. The reduced frequency, defined by 

k r = a>c/2|V|oo, where to is in radians/second, is 4.0. (Note that the input to CFL3D 

defines to in cycles/second; therefore, rfreq = 0.63662.) The plate vibration generates 
acoustic waves which propagate both downstream and upstream. The solution invokes 
periodicity at both the upper and lower boundaries (except between x = 0.0 and x = 1 .0), 
thus mimicking an infinite row of flat plates. 
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This example also employs a second block downstream of x = 2.0. This block is a 
“sliding block” that is used to test the effect of a sliding block interface (such as might be 
used in a rotor-stator computation) on the transmission of acoustic waves. Currently, it is 
set to translate “up” with speed w/a „ = 1/n = 0.31831 . 

This test problem is set up to run for 961 time steps, using three multigrid sub-itera- 
tions per time step. The time step is 7t/320 = 0.0098175. At this time step, 160 time steps 
yield one complete cycle of plate oscillation, so 961 steps yield six complete cycles of 
plate oscillations. The code, taking advantage of the periodicity of the solution, “resets” 
the sliding zone (zone 2) whenever its motion exceeds dzmax = 1 .0. At the end of time 
step 961, zone 2 is again physically aligned with zone 1. If the number of steps taken is 
such that ntstep-1 is not evenly divisible by 160, then zone 2 will appear displaced some 
distance “up” from zone 1 when looking at the solution. While this is not a problem since 
the solution is periodic, it is easier to visualize the whole flow field when the two zones are 
aligned. 

The grid consists of two grid zones with a total of 5502 points. The memory require- 
ment for this case is 2. 1 million words. A typical timing for six cycles of plate oscillation 
is 422 CPU seconds on a CRAY YMP (NASA LaRC’s Sabre as of July 1996). 

Besides the CFL3D code the following files are needed to run this test case: 


File Description 

vibrate . inp input for CFL3D 

cartesian . f grid generator 

The steps for running this case on the YMP are as follows: 

Step l 

Compile the grid generator code: 

cft77 cartesian. f 

Step 2 

Link the grid converter object file: 

segldr -o cartesian cartesian. o 

Step 3 

Run the grid generator program (the binary file grid.bin will be output): 

cartesian 

In answer to the questions, type 
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2 

- 6 , 2 , 0, 1 
.05, .05 
0 

2,7, 0,1 
.05, .05 
0 


Step 4 

Use the makefile to compile, link, and create the executable for the precfi3d code (be 
sure precf l . h is in the current directory): 

make -f makeprecf 13d_cray 

Step, 5 

Run the precf 13d code (the cflx.h files will be output): 

precf 13d < vibrate. inp 


Step 6 

Use the makefile to compile, link, and create the executable for the CFL3D code: 

make -f makecf 13d_cray 

Step 2. 

Run the CFL3D code: 

cf!3d < vibrate. inp 


The input file for this case is: 

I/O FILES 
gri d . bin 
plot 3dg . bin 
piot3dq.bin 
cf I3d. out 
cf 13d. res 
cf 1 3d . turres 
cf 1 3d . blomax 
cf 13d . outl5 
cf 1 3d . prout 
cf 13d. out20 
ovrlp . bin 
patch . bin 
restart . bin 


Flat plate 

vibrating 

cascade 

with sliding 

interface 

downstream 

XMACH 

ALPHA 

BETA 

REUE , MIL 

TINF , DR 

IALPH IHSTRY 

.500 

0.00 

0.0 

1.07 

520.0 

0 0 

SREF 

CREF 

BREF 

XMC 

YMC 

ZMC 

1.00000 

1.00000 

1.0000 

0.25000 

0.00 

0.00 

DT 

IREST 

IFLAGTS 

FMAX 

IUNST 

CFLTAU 

.0098175 

0 

000 

1.00 

1 

5. 
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NGRID 

NPLOT3D 

NPRINT 

NWREST 

ICHK 

I2D 

NTSTEP 

ITA 


2 

2 

2 

2000 

0 

1 

961 

-2 


NCG 

I EM 

IADVANCE 

IFORCE 

IVISC(I) 

IVISC(J) 

IVISC (K) 



2 

0 

0 

001 

0 

0 

0 



2 

0 

0 

001 

0 

0 

0 



IDIM 

JDIM 

KDIM 







2 

161 

21 







2 

101 

21 







ILAMLO 

ILAMHI 

JLAMLO 

JLAMHI 

KLAMLO 

KLAMHI 




00 

00 

000 

000 

0 

0000 




00 

00 

000 

000 

0 

0000 




INEWG 

IGRIDC 

IS 

JS 

KS 

IE 

JE 

KE 


0 

0 

0 

0 

0 

0 

0 

0 


0 

0 

0 

0 

0 

0 

0 

0 


IDIAG(I) 

IDIAG(J) 

IDIAG(K) 

IFLIM(I) 

IFLIM(J) 

IFLIM (K) 




1 

1 

1 

0 

0 

0 




1 

1 

1 

0 

0 

0 




IFDS(I) 

IFDS(J) 

IFDS(K) 

RKAP0 (I) 

RKAP0 (J) 

RKAP0 (K) 




1 

1 

1 

.3333 

.3333 

.3333 




1 

1 

1 

.3333 

.3333 

.3333 




GRID 

NBCIO 

NBCIDIM 

NBC JO 

NBCJDIM 

NBCKO 

NBCKDIM 

IOVRLP 

t 

1 

1 

1 

1 

1 

3 

3 

0 

J 

1 

1 

2 

1 

1 

1 

1 

1 

1 

0 

1 

10: GRID 

SEGMENT 

BCTYPE 

JSTA 

JEND 

KSTA 

KEND 

NDATA 


1 

1 

1001 

0 

0 

0 

0 

0 


2 

1 

1001 

0 

0 

0 

0 

0 


IDIM: GRID 

SEGMENT 

BCTYPE 

JSTA 

JEND 

KSTA 

KEND 

NDATA 


1 

1 

1002 

0 

0 

0 

0 

0 


2 

1 

1002 

0 

0 

0 

0 

0 


JO: GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

KSTA 

KEND 

NDATA 


1 

1 

1003 

0 

0 

0 

0 

0 


2 

1 

0 

0 

0 

0 

0 

0 


JDIM: GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

KSTA 

KEND 

NDATA 


1 

1 

0 

0 

0 

0 

0 

0 


2 

1 

1003 

0 

0 

0 

0 

0 


K0: GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

JSTA 

JEND 

NDATA 

t 

1 

1 

2005 

1 

2 

1 

121 

4 

5 


NBLP 

DTHTX 

DTHTY 

DTHTZ 




1 


1 

0.0 

0. 

0, 




l 

1 

2 

1005 

1 

2 

121 

141 

0 

i 

1 

3 

2005 

1 

2 

141 

161 

4 

? 


NBLP 

DTHTX 

DTHTY 

DTHTZ 






1 

0.0 

0. 

0. 




- 

2 

1 

2005 

0 

0 

0 

0 

4 

* 


NBLP 

DTHTX 

DTHTY 

DTHTZ 






2 

0.0 

0. 

0. 




" 

KDIM : GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

JSTA 

JEND 

NDATA 


1 

1 

2005 

1 

2 

1 

121 

4 

- 


NBLP 

DTHTX 

DTHTY 

DTHTZ 




t 


1 

0.0 

0. 

0. 




: 

1 

2 

1005 

1 

2 

121 

141 

0 

j] 

1 

3 

2005 

1 

2 

141 

161 

4 

: 


NBLP 

DTHTX 

DTHTY 

DTHTZ 






1 

0.0 

0. 

0. 





2 

1 

2005 

0 

0 

0 

0 

4 

- 


NBLP 

DTHTX 

DTHTY 

DTHTZ 






2 

0.0 

0. 

0. 



, 

5 

MSEQ 

MGFLAG 

ICONSF 

MTT 

NGAM 





1 

1 

1 

0 

02 




= 

ISSC 

EPSSC (1) 

EPSSC { 2 ) 

EPSSC (3} 

ISSR 

EPSSR(l) 

EPSSR ( 2 ) 

EPSSR ( 3 ) 


0 

.3 

.3 

.3 

0 

.3 

.3 

.3 


NCYC 

MGLEVG 

NEMGL 

NITFO 





- 

3 

03 

00 

000 





- 

MIT1 

MIT2 

MIT3 

MIT4 

MIT5 





01 

01 

01 

01 

01 





1-1 BLOCKING DATA: 

NBLI 

0 

NUMBER GRID : ISTA JSTA KSTA I END JEND KEND ISVAl ISVA2 

NUMBER GRID : ISTA JSTA KSTA I END JEND KEND ISVAl ISVA2 

PATCH SURFACE DATA: 

NINTER 
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0 

PLOT 3D OUTPUT: 

GRID IPTYPE ISTART I END I INC JSTART JEND JINC KSTART KEND KINC 

1 0 1 999 1 01 999 1 1 999 1 

2 0 1 999 1 01 999 1 1 999 1 

MOVIE 

0 

PRINT OUT: 

GRID IPTYPE ISTART I END IINC JSTART JEND JINC KSTART KEND KINC 

11121 999 999 1 1 999 1 

211211111 999 1 

CONTROL SURFACE: 

NCS 

0 

GRID ISTART I END JSTART JEND KSTART KEND IWALL INORM 


IOVING GRID DATA - 

TRANSLATION 



NT RAN S 
2 

LREF 

0.5 

GRID 

ITRANS 

RFREQ 

XMAG 

YMAG 

ZMAG 

1 

2 

.31831 

0 . 

0. 

0.00100 

2 

1 

0. 

0. 

0. 

0.31831 

GRID 

1 

2 

DXMAX 

0. 

0. 

DYMAX 

0. 

0. 

DZMAX 

0.000 

1.000 




MOVING GRID DATA - ROTATION 
NROTAT 
0 

LREF 

GRID IROTAT RFREQ THXMAG THYMAG THZMAG XORIG YORIG ZORIG 

GRID THXMAX THYMAX THZMAX 

DYNAMIC PATCH INPUT DATA 
NINTER 
2 


INT 

IFIT 

LIMIT 

ITMAX 

MCXIE 

MCETA 

C-0 

I OR PH 

1 

-1 

5 

20 

0 

0 

0 

0 

2 

-1 

5 

20 

0 

0 

0 

0 

INT 

TO 

XIE1 

XIE2 

ETA1 

ETA2 

NFB 


1 

122 

0 

0 

0 

0 

2 



FROM 

XIE1 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 


221 

0 

0 

0 

0 

0 . 

0 . 



DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 



0 . 

0 . 

0 . 

0 . 

0 . 

0 . 


FROM 

XIE1 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 


221 

0 

0 

0 

0 

0 . 

0 . 



DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 



0 . 

0 . 

-1 . 

0 . 

0 . 

0 . 

INT 

TO 

XIEl 

XIE2 

ETAl 

ETA2 

NFB 


2 

221 

0 

0 

0 

0 

2 



FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 


122 

0 

0 

0 

0 

0 . 

0 . 



DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 



0 . 

0 . 

0 . 

0 . 

0 . 

0 . 


FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 


122 

0 

0 

0 

0 

0 . 

0 . 



DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 



0 . 

0 . 

+ 1 . 

0 . 

0 . 

0 . 


The resulting residual and lift coefficient histories for this case are shown in Figure 9- 
13 and Figure 9-14, respectively. The oscillatory nature of the flow is clearly evident. 
Figure 9-15 shows a profile of the flow as defined by pressure contours. 
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iterations 

Figure 9-13. Residual history for inviscid flow through vibrating flat plates. 



iterations 

Figure 9 - 14 . Lift coefficient history for inviscid flow through vibrating flat plates: 

AC = 0.5. 


182 CFUD User's Manual 



9.1.6 Vibrating Flat Plates 



K i 

vibrating plate 


Figure 9-15. Pressure contours for inviscid flow through vibrating flat plates; = 0.5 . 
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9.1.7 Multistream Nozzle 

This case simulates, in two dimensions, the flow though a converging/di verging nozzle 
with multiple streams. The case is meant to model the exhaust from an engine (with a hot 
core and cooler outer flow modeled as a “top hat” temperature profile) entering an s- 
shaped converging/diverging nozzle. Two additional streams are injected downstream of 
the throat to provide additional cooling of the exhaust. 

The grid consists of thirteen patched zones with a total of 15897 points in one plane. 
The memory requirement for this example is 3.2 million words. A typical timing for this 
case is 1550 CPU seconds on a CRAY YMP (NASA LaRC’s Sabre as of October 1996). A 
cross-section of the grid is shown in Figure 9-16. 


2D Multistream Nozzle 

Subsonic 



Figure 9-16. Cross-section of multistream nozzle zonal patching and Mach contours. 

Boundary conditions with user-defined input, including constant data supplied via the 
main input deck and variable (point-to-point) data supplied via an auxiliary boundary con- 
dition data file are exemplified. Control surfaces are used to monitor mass-flow conver- 
gence (here, two control surfaces are used to measure the “difference” between mass in 
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and mass out). In addition, the case illustrates how one can define reference conditions for 
CFL3D in the case of a purely internal flow, as discussed below. 

9. 1. 7. 1 Nondimensionalization 

The conditions provided for this case are that the total pressure of the primary inflow is 
50 psi, with a total temperature of 1960°R in the core and 760°R in the outer region. The 
flow enters the s-duct with zero angle. The secondary cooling flows also have a total pres- 
sure of 50 psi and a uniform total temperature of 760°R . The cooling flow enters at -9 
degrees relative to horizontal. The exhaust from the nozzle system is supersonic. The 
throat height is 1 foot. The primary inflow height is 1.449 feet; the core flow region (i.e. 
where the total temperature is 1960°R ) spans the central 0.769 feet. 

Although inflow stagnation conditions would be a natural reference state for this prob- 
lem, the associated Mach number is zero. Since the viscous terms are scaled with the ref- 
erence Mach number, another reference state is needed. A second natural reference state 
for nozzle flows is the sonic point. From isentropic relations, the sonic conditions can be 
obtained once the inflow total conditions are known. However, for this problem there are 
two total conditions owing to the “top hat” temperature profile. Thus, to have just one ref- 
erence state, the total temperature of the inflow is area-averaged and the resulting average 
total temperature, together with the given total pressure, is used to determine the sonic 
conditions at the throat. 


In what follows, stagnation conditions are denoted by 0, sonic conditions by *, and 
dimensional quantities by ~. First, determine the average inflow total temperature: 

T = 0-769 , (1.449-0.769) _ 

0 1.449(1960) 1.449(760) 1397 R (JM) 

Next, determine the stagnation density and speed of sound: 

= W 0 " ! Sj = 000300 slugs/fee ’ 3 


5 0 = JyRTo = Vl-4( 1716)( 1397) = 1832 feet/second 


where R = 1716 feet 2 /(second 2 -°R). From the isentropic relations. 


— = 0.528, = 0.833, = 0.634, — = 0.913 

P 0 1 0 Po a 0 


Thus, the desired reference pressure, temperature, speed of sound and density are 
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p = 50(0.528) = 26.4 psi 
T = 1397(0.833) = 1164°R 

(9-5) 

p = 0.003(0.634) = 0.0019 slug/feet 
a = 1832(0.913) = 1673 feet/second 

Assuming a molecular viscosity coefficient of 3.7x10 7 slugs/(feet-seconds) for a 

0 76 

temperature of 520°R , then the power law p 2 /p, = ( T 2 /T 0 8 ives 

p* = 3.7xl0~ 7 ^-^j = 6.82xl0 -7 slugs/(feet-seconds) (9-6) 

The reference Reynolds number based on throat height and the reference sonic values 
is 


Re * = P*Q*( throat height) = a0019(16 73) 1 = 4.66xl0 6 

p* 6.82x10 

In the grid, the throat height is 12 inches, so the input parameter reue is 


reue 


Re*x 10 
12 


4.66 

12 


0.388 


(9-7) 


(9-8) 


Finally, the nondimensional input values for boundary condition type 2003 are deter- 
mined from the reference sonic conditions (note that in CFL3D parlance, in this problem 
the * conditions are the “infinity” conditions): 


p = 50 psi -> — = — = — = 1.894 
P< P p * Poa 26.4 

T, T, 760 

T = 760°R - =r- = = 0.653 

T* T M 1164 


T, T i960 

T, = 1960°R -> — = tf- = tt 77 
1 7* 7 1164 


= 1.684 


(9-9) 


Boundary condition type 2003 also needs an estimate of the local Mach number. For 
the primary inflow, the inlet height (area) to throat height (area) is 1.449/1. The isentropic 
relations give a corresponding Mach number of approximately 0.45. The local Mach num- 
ber for the cooling inflow cannot be determined a priori; 1.0 is used in the boundary condi- 
tion. The computations give the cooling inflow Mach number as approximately 0.85; 1.0 is 
deemed as a sufficiently close estimate since the solution does not change perceptibly if 
0.85 is used instead of 1.0. 
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The auxiliary boundary condition data file provided for this example (inflow. data) 
contains the data for the primary inflow: 

M = 0.45 

Pi 

- = 1.894 

P ~ (9-10) 

T t = 0.653 
T. . 1.684 

in top hat distribution, a = 0, P = 0 . The cooling inflow: 

M = 1.0 


- = 1.894 

P oo 

T t 

J- = 0.653 


a = -9 


P = o 


is specified explicitly in the main data file. 


9. 1.7.2 Running CFL3D 


Besides the CFL3D and ronnie codes the following files are needed to run this test 


multistream. inp 
grid_multistream . fmt 
f ormtobin . f 


inflow. data 


ronl . h 


ronnie . mp 


Description 
input for CFL3D 
formatted grid 
grid converter 

auxiliary boundary condition data 
parameters for ronnie makefile 
input for ronnie 


The steps for running this case on the YMP are as follows: 


Step 1 


Compile the grid converter code: 


cft77 formtobin.f 
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Step 2 

Link the grid converter object file: 

segldr -o formtobin formtobin.o 

Step 3 

Run the grid generator program (the binary file grid_muitistream.bin will be output): 

formtobin 

Step 4 

Use the makefile to compile, link, and create the executable for the ronnie code (be sure 
roni .h is in the current directory): 

make -f makeronnie_cray 

Step 5 

Run the ronnie code (the file patch_muitistream.bin will be output): 

ronnie < ronnie. inp 

Step 6 

Use the makefile to compile, link, and create the executable for the precfi3d code (be 
sure precf l . h is in the current directory): 

make -f makeprecf 13d_cray 

Step 7 

Run the precfl3d code (the cflx.h files will be output): 

precf 13d < multistream. inp 

Step 8 

Use the makefile to compile, link, and create the executable for the CFL3D code: 

make -f makecf 13d_cray 

Step 9 

Run the CFL3D code (be sure the inf low. data file is available and correct for this case): 

cfl3d < multistream. inp 

The input file for this case is: 

I/O FILES 

grid_multistream.p3d 

plot3dg.bin 


188 CFL3D User’s Manual 


ill; 



9.1.7 Multistream Nozzle 


plot3dq.bin 
cf 13d. out 
cf 13d. res 
cf 13d. turres 
cf 13d . blomax 
cf I3d. outl5 
cf 13d . prout 
cf 13d . out2 0 
ovrlp.bin 

patch_multistream.bin 
restart .bin 


Mult istream 

Nozzle 

(sonic conditions as 

reference 

state) 


XMACH 

ALPHA 

BETA 

REUE, MIL 

TINF , DR 

IALPH 

IHIST 

1.000 

0.00 

0.0 

0.388 

1163.0 

1 

1 

SREF 

CREF 

BREF 

XMC 

YMC 

ZMC 


1 . 00000 

1.00000 

1.0000 

0.25000 

0.00 

0.00 


DT 

IREST 

IFLAGTS 

FMAX 

IUNST 

CFL TAU 


-1.0000 

0 

000 

1.0 

+ 1 

5. 


NGRID 

NPLOT3D 

NPRINT 

NWREST 

ICHK 

I2D 

NTSTEP 

-13 

13 

0 

500 

0 

1 

2 

NCG 

I EM 

I ADVANCE 

IFORCE 

IVISC(I) 

IVISC(J) 

IVISC(K) 

1 

0 

0 

000 

0 

0 

+ 7 

1 

0 

0 

000 

0 

0 

+ 7 

1 

0 

0 

000 

0 

0 

+ 7 

1 

0 

0 

000 

0 

0 

+ 7 

1 

0 

0 

000 

0 

0 

+ 7 

1 

0 

0 

000 

0 

0 

+ 7 

1 

0 

0 

000 

0 

0 

+ 7 

1 

0 

0 

000 

0 

0 

+ 7 

1 

0 

0 

000 

0 

0 

+ 7 

1 

0 

0 

000 

0 

0 

+ 7 

1 

0 

0 

000 

0 

0 

+7 

1 

0 

0 

000 

0 

0 

+ 7 

1 

0 

0 

000 

0 

0 

+ 7 

IDIM 

JDIM 

KDIM 





2 

23 

41 





2 

23 

41 





2 

23 

41 





2 

23 

41 





2 

25 

41 





2 

25 

41 





2 

17 

21 





2 

17 

21 





2 

49 

41 





2 

49 

21 





2 

49 

21 





2 

41 

61 





2 

49 

57 





ILAMLO 

ILAMHI 

JLAMLO 

JLAMHI 

KLAMLO 

KLAMHI 


00 

00 

000 

000 

0 

0000 


00 

00 

000 

000 

0 

0000 


00 

00 

000 

000 

0 

0000 


00 

00 

000 

000 

0 

0000 


00 

00 

000 

000 

0 

0000 


00 

00 

000 

000 

0 

0000 


00 

00 

000 

000 

0 

0000 


00 

00 

000 

000 

0 

0000 


00 

00 

000 

000 

0 

0000 


00 

00 

000 

000 

0 

0000 


00 

00 

000 

000 

0 

0000 


00 

00 

000 

000 

0 

0000 


00 

00 

000 

000 

0 

0000 


INEWG 

IGRIDC 

IS 

JS 

KS 

IE 

JE 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 


ITA 

-2 


KE 

0 

0 

0 

0 

0 

0 

0 

0 

0 
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IDIAG(I) 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 


IDIAG(J) 

1 


IDIAG(K) 


IFLIM(I) 

3 


IFLIM(J) 

3 


IFLIM(K) 

3 


\ 

IFDS(I) 

IFDS(J) 

IFDS(K) 

RKAPO (I) 

RKAPO ( J) 

RKAPO (K) 


1 

1 

1 

.3333 

.3333 

.3333 


x 

1 

1 

.3333 

.3333 

.3333 

i 

1 

1 

1 

.3333 

.3333 

.3333 

1 

1 

1 

1 

.3333 

.3333 

.3333 

1 

1 

1 

1 

.3333 

.3333 

.3333 

1 

1 

1 

1 

.3333 

.3333 

.3333 

i 

1 

1 

1 

.3333 

.3333 

.3333 

= 

1 

1 

1 

.3333 

.3333 

.3333 


1 

1 

1 

.3333 

.3333 

.3333 

i 

1 

1 

1 

. 3333 

.3333 

.3333 


1 

1 

1 

.3333 

.3333 

.3333 


1 

1 

1 

.3333 

.3333 

.3333 

1 

1 

1 

1 

.3333 

.3333 

.3333 


GRID 

NBC 10 

NBCIDIM 

NBC JO 

NBCJDIM 

NBCKO 

| 

1 

1 

1 

1 

1 

1 

i 

2 

1 

1 

1 

1 

1 


3 

1 

1 

1 

1 

1 


4 

1 

1 

1 

1 

1 


5 

1 

1 

1 

1 

1 

z 

6 

1 

1 

1 

1 

1 

- 

7 

1 

1 

1 

1 

1 


8 

1 

1 

1 

1 

1 


9 

1 

1 

1 

1 

1 

1 

10 

1 

1 

1 

1 

1 

J 

11 

1 

1 

1 

1 

1 

- 

12 

1 

1 

1 

1 

1 


13 

1 

1 

1 

1 

1 

- 

10 : GRID 

SEGMENT 

BCTYPE 

JSTA 

JEND 

KSTA 


1 

1 

1002 

0 

0 

0 

■- 

2 

1 

1002 

0 

0 

0 


3 

1 

1002 

0 

0 

0 


4 

1 

1002 

0 

0 

0 


5 

1 

1002 

0 

0 

0 


6 

1 

1002 

0 

0 

0 


7 

1 

1002 

0 

0 

0 


8 

1 

1002 

0 

0 

0 


9 

1 

1002 

0 

0 

0 

- 

10 

1 

1002 

0 

0 

0 


11 

1 

1002 

0 

0 

0 


12 

1 

1002 

0 

0 

0 


13 

1 

1002 

0 

0 

0 


IDIM: GRID 

SEGMENT 

BCTYPE 

JSTA 

JEND 

KSTA 


1 

1 

1002 

0 

0 

0 


2 

1 

1002 

0 

0 

0 


3 

1 

1002 

0 

0 

0 


4 

1 

1002 

0 

0 

0 

- 

5 

1 

1002 

0 

0 

0 


NBCKDIM 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

KEND 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

KEND 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 
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12 

1 

1002 

0 

0 

0 

0 

0 

13 

1 

1002 

0 

0 

0 

0 

0 

JO : GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

KSTA 

KEND 

NDATA 

1 1 

Mach Pt/Pinf Tt/Tinf 

2003 

alpha 

0 

beta 

0 

0 

0 

-5 

inf low. data 

2 

1 

0 

0 

0 

0 

0 

0 

3 

1 

0 

0 

0 

0 

0 

0 

4 

1 

0 

0 

0 

0 

0 

0 

5 

1 

0 

0 

0 

0 

0 

0 

6 

1 

0 

0 

0 

0 

0 

0 

7 1 

Mach Pt/Pinf Tt/Tinf 
1.00 1.894 0.653 

2003 

alpha 

-9. 

0 

beta 

0. 

0 

0 

0 

5 

8 1 

Mach Pt/Pinf Tt/Tinf 
1.00 1.894 0.653 

2003 
alpha 
-9 . 

0 

beta 

0. 

0 

0 

0 

5 

9 

1 

0 

0 

0 

0 

0 

0 

10 

1 

0 

0 

0 

0 

0 

0 

11 

1 

0 

0 

0 

0 

0 

0 

12 

1 

0 

0 

0 

0 

0 

0 

13 

1 

0 

0 

0 

0 

0 

0 

JDIM: GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

KSTA 

KEND 

NDATA 

1 

1 

0 

0 

0 

0 

0 

0 

2 

1 

0 

0 

0 

0 

0 

0 

3 

1 

0 

0 

0 

0 

0 

0 

4 

1 

0 

0 

0 

0 

0 

0 

5 

1 

0 

0 

0 

0 

0 

0 

6 

1 

0 

0 

0 

0 

0 

0 

7 

1 

0 

0 

0 

0 

0 

0 

8 

1 

0 

0 

0 

0 

0 

0 

9 

1 

0 

0 

0 

0 

0 

0 

10 

1 

0 

0 

0 

0 

0 

0 

11 

1 

0 

0 

0 

0 

0 

0 

12 

1 

0 

0 

0 

0 

0 

0 

13 

1 

1002 

0 

0 

0 

0 

0 

K0 : GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

JSTA 

JEND 

NDATA 

1 

1 

2004 

0 

0 

0 

0 

2 

Tw Cq 

0. 0. 

2 

1 

2004 

0 

0 

0 

0 

2 

Tw Cq 

0. 0. 

3 

1 

2004 

0 

0 

0 

0 

2 

Tw Cq 

0. 0. 

4 

1 

2004 

0 

0 

0 

0 

2 

Tw Cq 

0. 0. 

5 

1 

2004 

0 

0 

0 

0 

2 

Tw Cq 

0. 0. 

6 

1 

2004 

0 

0 

0 

0 

2 

Tw Cq 

0. 0. 

7 

1 

2004 

0 

0 

0 

0 

2 

Tw Cq 

0. 0. 

8 

1 

2004 

0 

0 

0 

0 

2 

Tw Cq 

0. 0. 

9 

1 

0 

0 

0 

0 

0 

0 

10 

1 

2004 

0 

0 

0 

0 

2 

Tw Cq 

0. 0. 

11 

1 

0 

0 

0 

0 

0 

0 

12 

1 

2004 

0 

0 

0 

0 

2 

Tw Cq 

0. 0. 

13 

1 

2004 

0 

0 

0 

0 

2 

Tw Cq 

0. 0. 
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KDIM: 

GRID 

SEGMENT 

BCTYPE 

ISTA 

IEND 

JSTA 

JEND 

NDATA 


1 

1 

2004 

0 

0 

0 

0 

2 

Tw 

Cq 








0. 

0. 









2 

1 

2004 

0 

0 

0 

0 

2 

Tw 

Cq 








0. 

0. 









3 

1 

2004 

0 

0 

0 

0 

2 

Tw 

Cq 








0. 

0. 









4 

1 

2004 

0 

0 

0 

0 

2 

Tw 

Cq 








0. 

0, 









5 

1 

2004 

0 

0 

0 

0 

2 

Tw 

Cq 








0. 

0. 









6 

1 

2004 

0 

0 

0 

0 

2 

Tw 

Cq 








0. 

0. 









7 

1 

2004 

0 

0 

0 

0 

2 

Tw 

Cq 








0. 

0. 









8 

1 

2004 

0 

0 

0 

0 

2 

Tw 

Cq 








0. 

0. 









9 

1 

0 

0 

0 

0 

0 

0 


10 

1 

0 

0 

0 

0 

0 

0 


11 

1 

2004 

0 

0 

0 

0 

2 

Tw 

Cq 








0. 

0. 









12 

1 

2004 

0 

0 

0 

0 

2 

Tw 

Cq 








0. 

0. 









13 

1 

2004 

0 

0 

0 

0 

2 

Tw 

Cq 








0, 

0. 









MSEQ 

MGFLAG 

ICONSF 

MTT 

NGAM 





1 

1 

1 

0 

02 





ISSC 

EPSSC(l) 

EPSSC (2 ) 

EPSSC (3) 

ISSR 

EPSSR(l) 

EPSSR ( 2 ) 

EPSSR ( 3 ) 


0 

.3 

.3 

.3 

0 

.3 

. 3 

.3 


NCYC 

MGLEVG 

NEMGL 

NITFO 






3000 

02 

00 

0 






MIT1 

MIT2 

MIT3 

MIT4 

MIT5 





01 

01 

01 

01 

01 





1-1 BLOCKING DATA: 

NBLI 

0 

NUMBER GRID : ISTA JSTA KSTA I END JEND KEND ISVAl ISVA2 

NUMBER GRID : ISTA JSTA KSTA I END JEND KEND ISVAl ISVA2 

PATCH SURFACE DATA: 

NINTER 

-1 

PLOT 3D OUTPUT: 

grid iptyp ista iend iinc jsta jend jinc ksta kend kinc 
10000000000 
20000000000 
30000000000 
40000000000 
50000000000 
60000000000 
70000000000 
80000000000 
90000000000 
10 0000000000 

11 oooooooooo 

12 0 0 0 0 0 0*0 0 0 0 

13 oooooooooo 

MOVIE 

0 

PRINT OUT: 

GRID IPTYPE ISTART IEND IINC JSTART JEND JINC KSTART KEND KINC 
CONTROL SURFACES: 


1 I 
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NCS 

4 

GRID ISTA I END JSTA JEND KSTA KEND IWALL INORM 
10011000 -1 

7 0011000 -1 
80011000 -1 

13 0 0 49 49 0 0 0 1 

The inflow. data file is: 

auxiliary be data, j-face of block 1, multistream nozzle 
40 , 2*1 

5 

40 * 0 . 4499999999999993 , 40 * 1 . 89399999999999 8 , 16 * 0 . 653000000000001 , 

8 * 1 . 685000000000004 , 16 * 0 . 653000000000001 , 40 * 0 ., 40 * 0 . 

After running this test case, the residual history and mass flow convergence history 
shown in Figure 9-17 results. Also, a plot of Mach contours should have the flow features 
of those plotted in Figure 9-16. 


2D Multistream Nozzle 



Iteration 


Figure 9-17. Multistream nozzle case residual and mass flow convergence history. 
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9.1.8 Rotor Stator 

This case simulates, in two dimensions, the unsteady flow through a single stage tur- 
bine in which the ratio of stator to rotor blades is 3:4. The axial gap between the two 
blades is 50% of the blade chord. The case exercises a number of capabilities of CFL3D 
including unsteady flow, moving (translating) zones, dynamic patching between zones in 
relative motion, grid overlapping, and boundary conditions with user-defined input. 

The original grid for this case was provided by D. J. Domey 17 of Western Michigan 
University, although the grid given out for the test case contains only half the number of 
points of the original grid. The grid consists of fourteen zones with a total of 18374 points 
in one plane. A close-up of the grid near the airfoil is shown in Figure 9-18. The grid 
zones communicate with one another through both patching and overlapping. At a time 
step of 1.0, it takes 270 time steps for the eight rotor zones (containing four blades) to 
completely traverse the six stator zones (containing three blades). The rotor zones are reset 
after each complete traverse. The input file is set for 1500 time steps (using five multigrid 
sub-iterations per time step), which is sufficient to establish a time-periodic solution.The 
memory requirement for this example is 4.0 million words. A typical timing for this case 
(1500 time steps) is 4205 CPU seconds on a Cray YMP (NASA LaRC’s Sabre as of Octo- 
ber 1996). On a DEC Alpha workstation, the timing is 18303 CPU seconds, using single 

precision (as of June 1996). 


2D Large Scale Rotating Rig 

^miet = 0-07 Re/L= 100,000 U^ s /U rotor =0.78 



Figure 9-18. Fourteen zone rotor-stator grid system and Mach contours. 


I Hi 
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9. 1.8.1 Experimental Conditions 

The experimental blade count was 22 stator blades and 28 rotor blades. In order to run 
an exact simulation, a minimum of 1 1 stator blades and 14 rotor blades would be required 
(Dring et.al 18 ). To reduce the problem size in the computation, the ratio of stator to rotor 
blades was reduced to 3:4 (equivalent to 21:28), and the stators were scaled by a factor of 
22/21 to maintain the same pitch-to-chord ratio as in the experiment. The experimental 
set-up was a three-dimensional configuration; the corresponding 2-d simulation was set up 
from conditions at the mid-span radius of 27 inches, for a rotor speed of 410 rpm, with a 
nominal axial velocity of 75 feet/second. The inlet Mach number in the experiment was 
approximately 0.07, and the Reynolds number/inch was approximately 100,000. 


9. 1.8.2 Input Setup 

Inlet conditions are used as the reference conditions, so xmach = 0.07. The grid is full 
scale, with dimensions in inches. Therefore, reue = 0.1. The inlet temperature was 
assumed to be 60 °F , so tinf =520 °R . 


Boundary condition type 2003 is used to specify total pressure and total temperature at 
the inlet. From isentropic flow relations or tables, for an inlet flow Mach number of 0.07, 


M 


inlet 


0.07 


P t, inlet 

Poo 


t, inlet 


1.0035 

1.0010 


(9-12) 


Also, alphae = betae = 0 (purely axial flow is assumed). 

Boundary condition type 2002 is used to specify an exit pressure. Domey gives a ratio 
of static pressure to inlet total pressure = 0.963 at the rotor trailing edge plane. Assuming 
this value to hold at the exit as well gives 


P exit 


P ’ 


P exit P t, inlet 
P t, inlet P 


= 0.963 x 1.0035 = 0.967 


(9-13) 


Note that the inflow Mach number used in boundary condition type 2003 is an esti- 
mate; if the exit pressure were not set correctly, the computed inflow Mach number would 
not be close to the specified inflow value (when a time-periodic state is reached or at con- 
vergence in steady state). By specifying control surfaces at the inflow plane, the user is 
able to verify after the computation is complete that the average inflow Mach number is 
approximately 0.07 1 ; this was deemed to be close enough to the desired value. If desired, 
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the exit pressure could be adjusted (raised in this case) and the solution re-run until a new 
time-periodic solution (and a new inlet Mach number) is estab'ished. 

It should be noted that the input grid is in PLOT3D format, with y as the “up” direc- 
tion (ialph = 1; z is the spanwise, 2-d direction). However, the grid motion parameters 
must be set as if z is the up direction. Recall that if the input grid has y as the up direction, 
CFL3D will internally swap y and z so that the code always computes on a grid in which 
Z is up. (See the caution in “LT35 - Translational Information and Velocities” on page 44.) 

Given the rotor speed and mid-span radius, the translational velocity for a 2-d simula- 
tion corresponding to the mid-span radius is 

w = ( or = (410/60 x 2^)(27/12) = 96.6 feet/second (9-14) 


This gives 


^axial 

XV 

trans 


75 

96.6 


= 0.78 


(9-15) 


The input value wtrans is vv , (raf!5 /a t)0 , so with the reference Mach number 0.07, wtrans - 
0.07/0.78 = (-) 0.0897 (the negative gives a downward rotor motion). 


In order to be able to run an arbitrarily long simulation, the grid resetting option was 
employed. The top-to-bottom length of the grid is 24.23514 inches and the rotor and stator 
zones start out in alignment, so dzmax = 24.23514. Thus the rotor zones are reset when- 
ever the displacement exceeds 24.23514 inches. 


9.1. 8.3 Running CFL3D 

Besides the CFL3D code, the following files are needed to run this test case: 


File 

lsrr . inp 

lsrr^coarse .p3d_fmt 
fmttobin_p3d . f 
magi . h 
maggie . inp 


Description 
input for CFL3D 
formatted single plane grid 
converter for creating 2 grid planes 
parameters for MaGGiE makefile 
input for MaGGiE 


The steps for running this case on the DEC are as follows: 
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Step l 

Compile the grid converter code: 

cft77 fmttobin_p3d . f 

Step 2 

Link the grid converter object file: 

segldr -o fmttobin_p3d fmttobin_p3d . o 

Step 3 

Run the grid converter program (the binary file lsrr_coarse.p3d will be output): 

fmttobin_p3d 

Step 4 

Use the makefile to compile, link, and create the executable for the MaGGiE code (be sure 
magi . h is in the current directory): 

make -f makemaggie_cray 

Step 5 

Run the MaGGiE code (the file ovrip.bin will be output): 

maggie < maggie.inp 

Step 6 

Use the makefile to compile, link, and create the executable for the precfl3d code (be 
sure precf l . h is in the current directory): 

make -f makeprecf 13d_cray 

Step 7 

Run the precf 13d code (the cflx.h files will be output): 

precfl3d < lsrr.inp 

Step 8 

Use the makefile to compile, fink, and create the executable for the CFL3D code: 

make -f makecf 13d_cray 

Step 9 

Run the CFL3D code: 
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cf 13d < lsrr.inp 


The input file for this case is: 


I/O FILES 
lsrr_coarse .p3d 
plot3dg.bin 
plot3dq.bin 
cf 13d . out 
cf 13d . res 
cf 13d . turres 
cf 13d.blomax 
cf 13d. out 15 
cf 13d.prout 
cf 13d. out20 
ovrlp . bin 
patch.bin 
restart .bin 

2D model of Pratt & 
XMACH ALPHA 

0.070 0.000 

SKEF CREF 

1.00000 1.00000 

DT I REST 

+1.0000 0 

NGRID NPLOT3D 

-14 14 

NCG I EM 

1 0 

1 0 

1 0 

1 0 

1 0 

1 0 

1 0 

1 0 

1 0 


Whitney Large Scale 
BETA REUE , MIL 


0.0 

BREF 

1.0000 

IFLAGTS 

000 

NPRINT 

0 

I ADVANCE 
0 


0.1 

XMC 

0.00000 
FMAX 
1.00 
NWREST 
100 
I FORCE 
0 


Rotating Rig (LSRR) - 50% Axial Gap 
TINF , DR IALPH IHSTRY 

520.0 1 0 

YMC ZMC 

0.0000 0.0000 

IUNST CFLJTAU 

1 5. 

ICHK I2D NTSTEP 1 

0 1 1500 

IVISC(I) IVISC(J) I VI SC (K) 

0 0 5 


IDIM 

JDIM 

KDIM 




002 

55 

23 




002 

61 

21 




002 

55 

23 




002 

61 

21 




002 

55 

23 




002 

61 

21 




002 

61 

23 




002 

61 

21 




002 

61 

23 




002 

61 

21 




002 

61 

23 




002 

61 

21 




002 

61 

23 




002 

61 

21 




LAMLO 

ILAMHI 

JLAMLO 

JLAMHI 

KLAMLO 

KLAMHI 

00 

00 

000 

000 

0 

0000 

00 

00 

000 

000 

0 

0000 

00 

00 

000 

000 

0 

0000 

00 

00 

000 

000 

0 

0000 

00 

00 

000 

000 

0 

0000 

00 

00 

000 

000 

0 

0000 

00 

00 

000 

000 

0 

0000 

00 

00 

000 

000 

0 

0000 

00 

00 

000 

000 

0 

0000 

00 

00 

000 

000 

0 

0000 

00 

00 

000 

000 

0 

0000 

00 

00 

000 

000 

0 

0000 
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00 

00 

000 

000 

0 

0000 



00 

00 

000 

000 

0 

0000 



INEWG 

IGRIDC 

IS 

JS 

KS 

IE 

JE 

K 

0 

0 

0 

0 

0 

0 

0 


0 

0 

0 

0 

0 

0 

0 


0 

0 

0 

0 

0 

0 

0 


0 

0 

0 

0 

0 

0 

0 


0 

0 

0 

0 

0 

0 

0 


0 

0 

0 

0 

0 

0 

0 


0 

0 

0 

0 

0 

0 

0 


0 

0 

0 

0 

0 

0 

0 


0 

0 

0 

0 

0 

0 

0 


0 

0 

0 

0 

0 

0 

0 


0 

0 

0 

0 

0 

0 

0 


0 

0 

0 

0 

0 

0 

0 


0 

0 

0 

0 

0 

0 

0 


0 

0 

0 

0 

0 

0 

0 


IDIAG(I) 

IDIAG(J) 

IDIAG(K) 

IFLIM(I) 

IFLIM(J) 

IFLIM(K) 



1 

1 

1 

0 

0 

0 



1 

1 

1 

0 

0 

0 



1 

1 

1 

0 

0 

0 



1 

1 

1 

0 

0 

0 



1 

1 

1 

0 

0 

0 



1 

1 

1 

0 

0 

0 



1 

1 

1 

0 

0 

0 



1 

1 

1 

0 

0 

0 



1 

1 

1 

0 

0 

0 



1 

1 

1 

0 

0 

0 



1 

1 

1 

0 

0 

0 



1 

1 

1 

0 

0 

0 



1 

1 

1 

0 

0 

0 



1 

1 

1 

0 

0 

0 



IFDS (I) 

IFDS ( J) 

IFDS (K) 

rkapo ( i) 

RKAPO (J) 

RKAPO (K) 



1 

1 

1 

.3333 

.3333 

.3333 



1 

1 

1 

.3333 

.3333 

.3333 



1 

1 

1 

.3333 

.3333 

.3333 



1 

1 

1 

.3333 

.3333 

.3333 



1 

1 

1 

. 3333 

.3333 

.3333 



1 

1 

1 

.3333 

.3333 

.3333 



1 

1 

1 

.3333 

.3333 

.3333 



1 

1 

1 

.3333 

.3333 

.3333 



1 

1 

1 

. 3333 

.3333 

.3333 



1 

1 

1 

.3333 

.3333 

.3333 



1 

1 

1 

.3333 

.3333 

.3333 



1 

1 

1 

.3333 

.3333 

.3333 



1 

1 

1 

.3333 

.3333 

.3333 



1 

1 

1 

.3333 

.3333 

.3333 



GRID 

NBCIO 

NBCIDIM 

NBC JO 

NBCJDIM 

NBCK0 

NBCKDIM 

IOVRLP 

1 

1 

1 

1 

1 

1 

1 

1 

2 

1 

1 

1 

1 

1 

1 

1 

3 

1 

1 

1 

1 

1 

1 

1 

4 

1 

1 

1 

1 

1 

1 

1 

5 

1 

1 

1 

1 

1 

1 

1 

6 

1 

1 

1 

1 

1 

1 

1 

7 

1 

1 

1 

1 

1 

1 

1 

8 

1 

1 

1 

1 

1 

1 

1 

9 

1 

1 

1 

1 

1 

1 

1 

10 

1 

1 

1 

1 

1 

1 

1 

11 

1 

1 

1 

1 

1 

1 

1 

12 

1 

1 

1 

1 

1 

1 

1 

13 

1 

1 

1 

1 

1 

1 

1 

14 

1 

1 

1 

1 

1 

1 

1 

: GRID 

SEGMENT 

BCTYPE 

JSTA 

JEND 

KSTA 

KEND 

NDATA 

1 

1 

1002 

0 

0 

0 

0 

0 

2 

1 

1002 

0 

0 

0 

0 

0 

3 

1 

1002 

0 

0 

0 

0 

0 

4 

1 

1002 

0 

0 

0 

0 

0 

5 

1 

1002 

0 

0 

0 

0 

0 

6 

1 

1002 

0 

0 

0 

0 

0 

7 

1 

1002 

0 

0 

0 

0 

0 

8 

1 

1002 

0 

0 

0 

0 

0 

9 

1 

1002 

0 

0 

0 

0 

0 
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10 

1 

1002 


0 

0 

0 

0 

0 


11 

1 

1002 


0 

0 

0 

0 

0 


12 

1 

1002 


0 

0 

0 

0 

0 


13 

1 

1002 


0 

0 

0 

0 

0 


14 

1 

1002 


0 

0 

0 

0 

0 

IDIM: 

GRID SEGMENT 

BCTYPE 


JSTA 

JEND 

KSTA 

KEND 

NDATA 


1 

1 

1002 


0 

0 

0 

0 

0 


2 

1 

1002 


0 

0 

0 

0 

0 


3 

1 

1002 


0 

0 

0 

0 

0 


4 

1 

1002 


0 

0 

0 

0 

0 


5 

1 

1002 


0 

0 

0 

0 

0 


6 

1 

1002 


0 

0 

0 

0 

0 


7 

1 

1002 


0 

0 

0 

0 

0 


8 

1 

1002 


0 

0 

0 

0 

0 


9 

1 

1002 


0 

0 

0 

0 

0 


10 

1 

1002 


0 

0 

0 

0 

0 


11 

1 

1002 


0 

0 

0 

0 

0 


12 

1 

1002 


0 

0 

0 

0 

0 


13 

1 

1002 


0 

0 

0 

0 

0 


14 

1 

1002 


0 

0 

0 

0 

0 

JO : 

GRID 

SEGMENT 

BCTYPE 


I ST A 

I END 

KSTA 

KEND 

NDATA 


1 

1 

2003 


0 

0 

0 

0 

5 

Mach 

Pt/Pinf 

Tt/Tinf 

alpha 

beta 






0.07 

1.0035 

1.0010 

0. 

0. 







2 

1 

0 


0 

0 

0 

0 

0 


3 

1 

2003 


0 

0 

0 

0 

5 

Mach 

Pt/Pinf 

Tt /Tinf 

alpha 

beta 






0.07 

1.0035 

1.0010 

0. 

0. 







4 

1 

0 


0 

0 

0 

0 

0 


5 

1 

2003 


0 

0 

0 

0 

5 

Mach 

Pt/Pinf 

Tt/Tinf 

alpha 

beta 






0.07 

1.0035 

1.0010 

0. 

0 . 







6 

1 

0 


0 

0 

0 

0 

0 


7 

1 

0 


0 

0 

0 

0 

0 


8 

1 

0 


0 

0 

0 

0 

0 


9 

1 

0 


0 

0 

0 

0 

0 


10 

1 

0 


0 

0 

0 

0 

0 


11 

1 

0 


0 

0 

0 

0 

0 


12 

1 

0 


0 

0 

0 

0 

0 


13 

1 

0 


0 

0 

0 

0 

0 


14 

1 

0 


0 

0 

0 

0 

0 

JDIM : 

GRID 

SEGMENT 

BCTYPE 


ISTA 

I END 

KSTA 

KEND 

NDATA 


1 

1 

0 


0 

0 

0 

0 

0 


2 

1 

0 


0 

0 

0 

0 

0 


3 

1 

0 


0 

0 

0 

0 

0 


4 

1 

0 


0 

0 

0 

0 

0 


5 

1 

0 


0 

0 

0 

0 

0 


6 

1 

0 


0 

0 

0 

0 

0 


7 

1 

2002 


0 

0 

0 

0 

1 


pexit/pinf 


V • -7 V / 

8 

1 

0 

0 

0 

0 

0 

0 

9 

1 

2002 

0 

0 

0 

0 

1 

pexit/pinf 

0.967 

10 

1 

0 

0 

0 

0 

0 

u 

11 

pexit/pinf 

1 

2002 

0 

0 

0 

0 

1 

0.967 

12 

1 

0 

0 

0 

0 

0 

u 

13 

1 

2002 

0 

0 

0 

0 

1 

pexit/pinf 

0.967 

14 

1 

0 

0 

0 

0 

0 

u 

KO: GRID SEGMENT 

BCTYPE 

ISTA 

I END 

JSTA 

JEND 

NDATA 

1 

1 

0 

0 

0 

0 

0 

0 

2 

1 

2004 

0 

0 

0 

0 

2 

Tw/Tinf C_q 

0. 0. 

3 

1 

0 

0 

0 

0 

0 

0 

4 

1 

2004 

0 

0 

0 

0 

2 

Tw/Tinf C_q 
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o 

o 









5 1 


0 

0 


0 

0 

0 

0 

6 1 

2004 

0 


0 

0 

0 

2 

Tw/Tinf C q 









0. 0. 









7 1 


0 

0 


0 

0 

0 

0 

8 1 

2004 

0 


0 

0 

0 

2 

Tw/Tinf C q 









0. 0. 









9 1 


0 

0 


0 

0 

0 

0 

10 1 

2004 

0 


0 

0 

0 

2 

Tw/Tinf C q 









0. 0. 









11 1 


0 

0 


0 

0 

0 

0 

12 1 

2004 

0 


0 

0 

0 

2 

Tw/Tinf C q 









0. 0. 









13 1 


0 

0 


0 

0 

0 

0 

14 1 

2004 

0 


0 

0 

0 

2 

Tw/Tinf C q 









0. 0. 









KDIM : GRID SEGMENT 

BCTYPE 

ISTA 

I END 

JSTA 

JEND 

NDATA 

1 1 


0 

0 


0 

0 

0 

0 

2 1 


0 

0 


0 

0 

0 

0 

3 1 


0 

0 


0 

0 

0 

0 

4 1 


0 

0 


0 

0 

0 

0 

5 1 


0 

0 


0 

0 

0 

0 

6 1 


0 

0 


0 

0 

0 

0 

7 1 


0 

0 


0 

0 

0 

0 

8 1 


0 

0 


0 

0 

0 

0 

9 1 


0 

0 


0 

0 

0 

0 

10 1 


0 

0 


0 

0 

0 

0 

11 1 


0 

0 


0 

0 

0 

0 

12 1 


0 

0 


0 

0 

0 

0 

13 1 


0 

0 


0 

0 

0 

0 

14 1 


0 

0 


0 

0 

0 

0 

MSEQ MG FLAG 

ICONSF 

MTT 

NGAM 




1 1 


1 

0 


01 




ISSC EPSSC(l) 

EPSSC ( 2 ) EPSSC ( 3 ) 

ISSR EPSSR(l) 

EPSSR (2 ) 

EPSSR ( 3 ) 

0 .3 


.3 

.3 


0 

.3 

.3 

.3 

NCYC MGLEVG 

NEMGL 

NITFO 






5 02 


00 

000 






MIT1 MIT2 

MIT3 

MIT4 

MIT5 




01 01 


01 

01 


01 




1-1 BLOCKING DATA: 









NBLI 









14 









NUMBER GRID : 

ISTA 

JSTA KSTA 

I END 

JEND 

1 KEND 

ISVAl 

ISVA2 

1 2 

1 

1 

1 

2 

1 

21 

1 

3 

2 4 

1 

1 

1 

2 

1 

21 

1 

3 

3 6 

1 

1 

1 

2 

1 

21 

1 

3 

4 8 

1 

1 

1 

2 

1 

21 

1 

3 

5 10 

1 

1 

1 

2 

1 

21 

1 

3 

6 12 

1 

1 

1 

2 

1 

21 

1 

3 

7 14 

1 

1 

1 

2 

1 

21 

1 

3 

8 1 

1 

1 

1 

2 

55 

1 

1 

2 

9 7 

1 

1 

1 

2 

61 

1 

1 

2 

10 1 

1 

1 

23 

2 

55 

23 

1 

2 

11 3 

1 

1 

23 

2 

55 

23 

1 

2 

12 7 

1 

1 

23 

2 

61 

23 

1 

2 

13 9 

1 

1 

23 

2 

61 

23 

1 

2 

14 11 

1 

1 

23 

2 

61 

23 

1 

2 

NUMBER GRID : 

ISTA 

JSTA 

KSTA 

I END 

JEND 

KEND 

ISVAl 

ISVA2 

1 2 

1 

61 

1 

2 

61 

21 

1 

3 

2 4 

1 

61 

1 

2 

61 

21 

1 

3 

3 6 

1 

61 

1 

2 

61 

21 

1 

3 

4 8 

1 

61 

1 

2 

61 

21 

1 

3 

5 10 

1 

61 

1 

2 

61 

21 

1 

3 

6 12 

1 

61 

1 

2 

61 

21 

1 

3 

7 14 

1 

61 

1 

2 

61 

21 

1 

3 

8 5 

1 

1 

23 

2 

55 

23 

1 

2 

9 13 

1 

1 

23 

2 

61 

23 

1 

2 
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PATCH SURFACE DATA: 
NINTER 
0 

PLOT 3D OUTPUT: 

BLOCK IPTYPE I START 
10 1 

2 0 1 

3 0 1 

4 0 1 

5 0 1 

6 0 1 

7 0 1 

8 0 1 

9 0 1 

10 0 1 

110 1 

12 0 1 

13 0 1 

14 0 1 

MOVIE 

0 

PRINT OUT: 

BLOCK IPTYPE ISTART 


I END 

I INC JSTART 

JEND 

001 

1 

01 

999 

001 

1 

01 

999 

001 

1 

01 

999 

001 

1 

01 

999 

001 

1 

01 

999 

001 

1 

01 

999 

001 

1 

01 

999 

001 

1 

01 

999 

001 

1 

01 

999 

001 

1 

01 

999 

001 

1 

01 

999 

001 

1 

01 

999 

001 

1 

01 

999 

001 

1 

01 

999 


JTNC KSTART KEND KINC 


I INC J START JEND JINC KSTART KEND KINC 


i 

CONTROL 

NCS 

7 

GRID 

SURFACES : 
ISTA IEND 

JSTA 

JEND 

KSTA 

KEND 

IWALL 

INORM 


7 

1 

2 

999 

999 

0 

0 

0 

1 


9 

1 

2 

999 

999 

0 

0 

0 

1 

\ 

11 

1 

2 

999 

999 

0 

0 

0 

1 

2 

1 

13 

1 

2 

999 

999 

0 

0 

0 

1 

a 

1 

1 

2 

1 

1 

0 

0 

0 

0 

’ 

3 

1 

2 

1 

1 

0 

0 

0 

0 


5 

1 

2 

1 

1 

0 

0 

0 

0 

- 

MOVING 

NTRANS 

GRID 

DATA - 

TRANSLATION 






3 

GRID 

I TRANS 

RFREQ 

UTRANS 

VTRANS 

WTRANS 

= 

7 

1 

0 . 

0 . 

0 . 

-0.0897 

" 

8 

1 

0 . 

0 . 

0 . 

-0.0897 


9 

1 

0 . 

0 . 

0 . 

-0.0897 


10 

1 

0 . 

0 . 

0 . 

-0.0897 


11 

1 

0 . 

0 . 

0 . 

-0.0897 


12 

1 

0 . 

0 . 

0 . 

-0.0897 


13 

1 

0 . 

0 . 

0 . 

-0.0897 


14 

1 

0 . 

0 . 

0 . 

-0 . 0897 


0 

1 

0 . 

0 . 

0 . 

-0.0897 


GRID 

DXMAX 

DYMAX 

DZMAX 



I 

7 

0 . 

0 . 

-24.23514 



= 

8 

0 . 

0 . 

-24 .23514 




9 

0 . 

0 . 

-24.23514 




10 

0 . 

0 . 

-24.23514 




11 

0 . 

0 . 

-24.23514 




12 

0 . 

0 . 

-24,23514 



i 

13 

0 . 

0 . 

-24.23514 




14 

0 . 

0 . 

-24.23514 




0 

0 . 

0 . 

-24.23514 




MOVING GRID DATA - ROTATION 
NROTAT 
0 

LREF 

GRID I ROT AT RFREQ OMEGAX 

GRID THXMAX THYMAX THZMAX 
DYNAMIC PATCH INPUT DATA 
NINTER 


OMEGAY OMEGAZ XORIG YORIG ZORIG 
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INT 

7 

IFIT 

LIMIT 

ITMAX 

MCXIE 

MCETA 

C-0 

IORPH 

ITOSS 

1 

1 

1 

30 

0 

0 

0 

0 

1 

2 

1 

1 

30 

0 

0 

0 

0 

1 

3 

1 

1 

30 

0 

0 

0 

0 

1 

4 

1 

1 

30 

0 

0 

0 

0 

1 

5 

1 

1 

30 

0 

0 

0 

0 

1 

6 

1 

1 

30 

0 

0 

0 

0 

1 

7 

1 

1 

30 

0 

0 

0 

0 

1 

INT 

TO 

XIE1 

XIE2 

ETA1 

ETA2 

NFB 



1 

122 

0 

0 

0 

0 

6 




FROM 

XIE1 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 



721 

0 

0 

0 

0 

0 . 

0 . 



DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 




0 . 

0 . 

0 . 

0 . 

0 . 

0 . 




FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 



921 

0 

0 

0 

0 

0 . 

0 . 



DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 




0 . 

0 . 

0 . 

0 . 

0 . 

0 . 




FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 



1121 

0 

0 

0 

0 

0 . 

0 . 



DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 




0 . 

0 . 

0 . 

0 . 

0 . 

0 . 




FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 



1321 

0 

0 

0 

0 

0 . 

0 . 



DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 




0 . 

0 . 

0 . 

0 . 

0 . 

0 . 




FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 



721 

0 

0 

0 

0 

0 . 

0 . 



DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 




0 . 

0 . 

24.23514 

0 . 

0 . 

0 . 




FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 



921 

0 

0 

0 

0 

0 . 

0 . 



DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 




0 . 

0 . 

24.23514 

0 . 

0 . 

0 . 



INT 

TO 

XIEl 

XIE2 

ETAl 

ETA2 

NFB 



2 

322 

0 

0 

0 

0 

6 




FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 



921 

0 

0 

0 

0 

0 . 

0 . 



DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 




0 . 

0 . 

0 . 

0 . 

0 . 

0 . 




FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 



1121 

0 

0 

0 

0 

0 . 

0 . 



DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 




0 . 

0 . 

0 . 

0 . 

0 . 

0 . 




FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 



1321 

0 

0 

0 

0 

0 . 

0 . 



DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 




0 . 

0 . 

0 . 

0 . 

0 . 

0 . 




FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 



721 

0 

0 

0 

0 

0 . 

0 . 



DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 




0 . 

0 . 

24.23514 

0 . 

0 . 

0 . 




FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 



921 

0 

0 

0 

0 

0 . 

0 . 



DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 




0 . 

0 . 

24.23514 

0 . 

0 . 

0 . 




FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 



1121 

0 

0 

0 

0 

0 . 

0 . 



DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 




0 . 

0 . 

24.23514 

0 . 

0 . 

0 . 



INT 

TO 

XIEl 

XIE2 

ETAl 

ETA2 

NFB 



3 

522 

0 

0 

0 

0 

6 




FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 



1121 

0 

0 

0 

0 

0 . 

0 . 



DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 




0 . 

0 . 

0 . 

0 . 

0 . 

0 . 




FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 



1321 

0 

0 

0 

0 

0 . 

0 . 



DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 




0 . 

0 . 

0 . 

0 . 

0 . 

0 . 




FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 
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721 

0 

0 

0 

0 

0 . 

0 . 

DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 


0 . 

0 . 

24.23514 

0 . 

0 . 

0 . 


FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 

921 

0 

0 

0 

0 

0 . 

0 . 

DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 


0 . 

0 . 

24.23514 

0 . 

0 . 

0 . 


FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 

1121 

0 

0 

0 

0 

0 . 

0 . 

DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 


0 . 

0 . 

24.23514 

0 . 

0 . 

0 . 


FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 

1321 

0 

0 

0 

0 

0 . 

0 . 

DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 


0 . 

0 . 

24.23514 

0 . 

0 . 

0 . 


INT TO 

XIEl 

XIE2 

ETAl 

ETA2 

NFB 


4 721 

0 

0 

0 

0 

4 


FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 

122 

0 

0 

0 

0 

0 . 

0 . 

DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 


0 . 

0 . 

0 . 

0 . 

0 . 

0 . 


FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 

522 

0 

0 

0 

0 

0 . 

0 . 

DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 


0 . 

0 . 

-24.23514 

0 . 

0 . 

0 . 


FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 

322 

0 

0 

0 

0 

0 . 

0 . 

DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 


0 . 

0 . 

-24.23514 

0 . 

0 . 

0 . 


FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 

122 

0 

0 

0 

0 

0 . 

0 . 

DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 


0 . 

0 . 

-24.23514 

0 . 

0 . 

0 . 


INT TO 

XIEl 

XIE2 

ETAl 

ETA2 

NFB 


5 921 

0 

0 

0 

0 

5 


FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 

122 

0 

0 

0 

0 

0 . 

0 . 

DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 


0 . 

0 . 

0 . 

0 . 

0 . 

0 . 


FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 

322 

0 

0 

0 

0 

0 . 

0 . 

DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 


0 . 

0 . 

0 . 

0 . 

0 . 

0 . 


FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 

522 

0 

0 

0 

0 

0 . 

0 . 

DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 


0 . 

0 . 

-24.23514 

0 . 

0 . 

0 . 


FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 

322 

0 

0 

0 

0 

0 . 

0 . 

DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 


0 . 

0 . 

-24.23514 

0 . 

0 . 

0 . 


FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 

122 

0 

0 

0 

0 

0 . 

0 . 

DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 


0 . 

0 . 

-24.23514 

0 . 

0 . 

0 . 


INT TO 

XIEl 

XIE2 

ETAl 

ETA2 

NFB 


6 1121 

0 

0 

0 

0 

5 


FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 

322 

0 

0 

0 

0 

0 . 

0 . 

DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 


0 . 

0 . 

0 . 

0 . 

0 . 

0 . 


FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 

522 

0 

0 

0 

0 

0 . 

0 . 

DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 


0 . 

0 . 

0 . 

0 . 

0 . 

0 . 


FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 

122 

0 

0 

0 

0 

0 . 

0 . 

DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 


0 . 

0 . 

0 . 

0 . 

0 . 

0 . 


FROM 

XIEl 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 

522 

0 

0 

0 

0 

0 . 

0 . 

DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 
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0 . 

0 . 

-24.23514 

0 . 

0 . 

0 . 


FROM 

XIE1 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 

322 

0 

0 

0 

0 

0 . 

0 . 

DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 


0 . 

0 . 

-24.23514 

0 . 

0 . 

0 . 


TO 

XIE1 

XIE2 

ETAl 

ETA2 

NFB 


1321 

0 

0 

0 

0 

4 


FROM 

XIE1 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 

522 

0 

0 

0 

0 

0 . 

0 . 

DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 


0 . 

0 . 

0 . 

0 . 

0 . 

0 . 


FROM 

XIE1 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 

322 

0 

0 

0 

0 

0 . 

0 . 

DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 


0 . 

0 . 

0 . 

0 . 

0 . 

0 . 


FROM 

XIE1 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 

122 

0 

0 

0 

0 

0 . 

0 . 

DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 


0 . 

0 . 

0 . 

0 . 

0 . 

0 . 


FROM 

XIE1 

XIE2 

ETAl 

ETA2 

FACTJ 

FACTK 

522 

0 

0 

0 

0 

0 . 

0 . 

DX 

DY 

DZ 

DTHETX 

DTHETY 

DTHETZ 


0 . 

0 . 

-24.23514 

0 . 

0 . 

0 . 



The convergence histories for residual, mass flow, and rotor lift coefficient as shown in 
Figure 9-19 should be obtained. 


2D Large Scale Rotating Rig 



Time Step 


Figure 9-i9. Convergence histories for rotor-stator case. 
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9.2 Three-dimensional Test Cases 
9.2.1 Axisymmetric Bump Flow 

This test case solves for the turbulent flow over an axisymmetric bump. The flow is 
modeled in 3-d using two computational planes (separated by an angle of 1 degree), with 
periodic boundary conditions; hence bctype is 2005 and dthtx is -1.0 and 1.0 on the 10 
and IDIM boundaries, respectively. The grid consists of a single zone with a total of 36562 
points. The memory requirement for this example is 4.9 million words. A typical timing 
for this case is 1026 CPU seconds on a CRAY YMP (NASA LaRC’s Sabre as of October 
1996). A close-up of the grid near the bump is shown in Figure 9-20. 



0.0 0.5 1.0 1-5 


Figure 9-20. Axisymmetric bump grid. 

Besides the CFL3D code, the following files are needed to run this test case: 

File Description 

bumpv5per iodic . inp input for CFL3D 

bump . grd formatted single plane grid 

gridaxi . f converter for creating 2 grid planes 

The steps for running this case on the YMP are as follows: 
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Step, l 

Compile the grid converter code: 

cft77 gridaxi . f 

Step 2 

Link the grid converter object file: 

segldr -o gridaxi gridaxi. o 

Step 3 

Run the grid converter program (the binary file bumpgrd.bin will be output): 

gridaxi 

In answer to the question, type: 

bump . grd 

Step 4 

Use the makefile to compile, link, and create the executable for the precfl3d code (be 
sure precf l . h is in the current directory): 

make -f makeprecf 13d_cray 

Step 5 

Run the precf 13d code (the cflx.h files will be output): 

precf 13d < bumpv5per iodic . inp 

Step 6 

Use the makefile to compile, link, and create the executable for the CFL3D code: 

make -f makecf 13d_cray 

Step 7 

Run the CFL3D code: 

cfl3d < bumpv5periodic . inp 

The input file for this case is: 

I/O FILES 
bumpgrd.bin 
plot3dg . bin 
plot3dq.bin 
cf 13d. out 
cf 13d. res 
cf 13d. turres 
cf 13d. blomax 
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cfl3d.out!5 
cf 13d.prout 
cf 13d. out20 
ovrlp.bin 
patch.bin 
restart .bin 


Axi symmetric bump 

flow, 3-d, using 2 

planes and periodic BCs 




XMACH 

ALPHA 

BETA 

REUE, MIL 


T INF, DR 

IALPH 

IHIST 



0.8750 

00.000 
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0 
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SREF 

CREF 

BREF 
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YMC 
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DT 
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IUNST 
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0 
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0 
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NGRID 
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NPRINT 
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I2D 

NTSTEP 
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1 
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I EM 
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i 

2 

0 

0 
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0 

0 

07 



IDIM 
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02 
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j 

ILAMLO 

ILAMHI 

JLAMLO 
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KLAMLO 

KLAMHI 



i 

I 

0 

0 

0 

0 


0 

0 



1 

INEWG 

IGRIDC 

IS 

JS 


KS 

IE 

JE 

KE 

i 

{ 

0 

0 

0 

0 


0 

0 

0 

0 


IDIAG { I ) 

IDIAG (J) 

IDIAG (K) 

IFLIM ( I } 

IFLIM ( J) 

IFLIM (K) 




1 

1 

1 

3 


3 

3 




IFDS(I) 

IFDS(J) 

IFDS(K) 

RKAP0 (I) 

RKAP0 (J) 

RKAP0 (K) 




1 

1 

1 

0.3333 


0.3333 

0.3333 




GRID 

NBCI0 

NBCIDIM 

NBC JO 


NBCJDIM 

NBCK0 NBCKDIM 

IOVRLP 


1 

1 

1 

1 


1 

1 

1 

0 


10: GRID 

SEGMENT 

BCTYPE 

JSTA 


JEND 

KSTA 

KEND 

NDATA 


1 

1 
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0 


0 

0 

0 

4 



NBLP 

DTHTX 

DTHTY 


DTHTZ 




i 


1 
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0. 


0. 




i 
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JSTA 
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KSTA 

KEND 

NDATA 

i 

I 

1 

1 

2005 

0 


0 

0 

0 

4 

i 


NBLP 

DTHTX 

DTHTY 


DTHTZ 




1 


1 

+ 1.0 

0. 


0. 





JO: GRID 

SEGMENT 

BCTYPE 

ISTA 


I END 

KSTA 

KEND 

NDATA 


1 

1 

1003 

0 


0 

0 

0 

0 


JDIM: GRID 

SEGMENT 

BCTYPE 

ISTA 


I END 

KSTA 

KEND 

NDATA 


1 

1 

1003 

0 


0 

0 

0 

0 


K0 : GRID 

SEGMENT 

BCTYPE 

ISTA 


TEND 

JSTA 

JEND 

NDATA 


1 

1 

2004 

0 


0 

0 

0 

2 



TWTYPE 

CQ 









0. 

0. 








KDIM: GRID 

SEGMENT 

BCTYPE 

ISTA 


I END 

JSTA 

JEND 

NDATA 


1 

1 

1003 

0 


0 

0 

0 

0 

! 

MSEQ 

MG FLAG 

ICONSF 

MTT 


NGAM 





1 

1 

0 

0 


02 




i 

ISSC 

EPSSSC ( 1 ) ] 

EPSSSC (2 ) 

EPSSSC (3) 


ISSR 

EPSSSR ( 1 ) EPSSSR (2 ) 

EPSSSR (3) 

I 

0 

0.3 

0.3 

0.3 


0 

0.3 

0.3 

0.3 


NCYC 

MGLEVG 

NEMGL 
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1 

1100 

03 

00 

000 






i 

MIT1 

MIT2 

MIT3 

MIT4 


MIT5 

MIT6 

MIT7 

MIT8 

I 

■ 

01 

01 

01 

01 


01 

1 

1 

1 

1 

1-1 BLOCKING DATA: 








i 

NBLI 

r\ 









1 

NUMBER GRID : 

ISTA 

JSTA KSTA 

I END 

JEND KEND 

ISVAl 

ISVA2 


NUMBER GRID : 

ISTA 

JSTA KSTA 

I END 

JEND KEND 

ISVAl 

ISVA2 


PATCH SURFACE DATA: 









NINTER 

A 










PLOT3D OUTPUT: 









BLOCK IPTYPE I START 

I END 

I INC J START 

JEND 

JINC KSTART 

KEND 

KINC 


1 

0 0 

0 

0 

0 

0 

0 0 

0 

0 

! 

IMOVIE 

n 









| 

PRINT OUT: 









BLOCK IPTYPE I START 

I END 

I INC J START 

JEND 

JINC KSTART 

KEND 

KINC 


1 

0 1 

1 

1 

0 

0 

0 1 

1 

1 

; 

E 


CONTROL SURFACE: 
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NCS 

0 

GRID ISTART TEND JSTART JEND KSTART KEND I WALL INORM 

After running this test case, the convergence history plots shown in Figure 9-21 should 
be duplicated. 



cycles cycles 

a) residual history b) lift coefficient history 



cycles cycles 

c) drag coefficient history d) moment coefficient history 

Figure 9-21. Residual and coefficient histories for axisymmetric bump flow case 

= 0.875 , Re- =2.66xl0 6 . 

l r 
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Also, a result such as that shown in Figure 9-22 should be obtained. In the figure, sur- 
face pressure coefficients are plotted along with experimental data for this case. The com- 
putational surface pressures can be obtained from file cfi3d.prout. Experimental surface 
pressure coefficients from Bachalo et. al 8 are included with this test case for comparison 
purposes. The file is called bumpcpdata . dat. 



0.4 0.6 0.8 1.0 1.2 1.4 1.6 
X 

Figure 9-22. Pressure coefficients for axisymmetric bump case 


M = 0.875, Re, =2.66xl0 6 . 

00 Ln 
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9.2.2 F-5 Wing 

The inviscid flow over an F-5 wing is solved in this test case. The grid consists of a 
single grid zone with a C-H mesh topology and is composed of 210,177 points. The mem- 
ory requirement for this example is 10.5 million words. A typical timing for this case is 
984 CPU seconds on a CRAY YMP (NASA LaRC’s Sabre as of September 1996). The 
wing surface grid and wake, as well as the plane of symmetry grid are illustrated in 
Figure 9-23. 



Figure 9-23. Single zone F-5 wing surface grid and plane of symmetry grid. 


Besides the CFL3D code the following files are needed to run this test case: 

File Description 

f 5wing . inp input for CFL3D 

f 5gr id . dat formatted wing section grid 

f 5 wi ng_g r i d . f grid converter 

The steps for running this case on the YMP are as follows: 

Step l 

Compile the grid converter code: 
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cft77 f 5wing_grid . f 

Step 2 

Link the grid converter object file: 

segldr -o f5wing_grid f 5wing_grid . o 

Step 3 

Run the grid converter program to generate the 3-d volume grid (the binary file 
f 5wing . grd will be output): 

f 5wing_grid 

Step 4 

Use the makefile to compile, link, and create the executable for the precfi3d code (be 
sure precf l .h is in the current directory): 

make -f makeprecf 13d_cray 

Step 5 

Run the precf 13d code (the c f lx. h files will be output): 
precf 13d < f5wing.inp 

Step: 6 

Use the makefile to compile, link, and create the executable for the CFL3D code: 

make -f makecf 13d_cray 


Step 7 

Run the CFL3D code: 

cfl3d < f5wing.inp 


The input file for this case is: 

I/O FILES: 
f 5wing . grd 
plot3dg . bin 
plot3dq.bin 
cf 13d. out 
cf 13d. res 
cf 13d. turres 
cf 13d.blomax 
cf 13d. outlS 
cf 13d.prout 
cf 13d. out20 
ovrlp .bin 
patch.bin 
restart . bin 

F5 Wing, cfl3d type grid 

XMACH ALPHA BETA REUE, MIL TINF , DR IALPH IHIST 
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0.0 
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DT 

IREST 
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FMAX 
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0 
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0 
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NGRID 

NPLOT3D 

NPRINT 

NWREST 

ICHK 

I2D 

NTSTEP 

ITA 


1 

0 

0 
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0 

0 

1 

1 


NCG 

I EM 

I ADVANCE 

IFORCE 

IVISC(I) 

IVISC(J) 

IVISC(K) 



2 

0 

0 

1 

0 

0 

0 



IDIM 

JDIM 

KDIM 







33 
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33 






ILAMLO 

ILAMHI 

JLAMLO 

JLAMHI 
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KLAMHI 




00 

00 

000 

000 

0 
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INEWG 

IGRIDC 

IS 

JS 

KS 

IE 

JE 

KE 


0 

0 

0 

0 

0 

0 

0 

0 

IDIAG { I ) 

IDIAG { J) 

IDIAG (K) 

IFLIM(I) 

IFLIM(J) 

IFLIM(K) 




1 

1 

1 

3 

3 

3 



IFDS(I) 

IFDS { J) 

IFDS (K) 

RKAP0 ( I ) 

RKAP0 { J) 

RKAP0 (K) 




1 

1 

1 
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GRID 

NBC 10 

NBC IDIM 
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NBCK0 

NBCKDIM 

IOVRLP 


1 

1 

1 

1 

1 

4 

1 

0 
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GRID 
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JSTA 

JEND 

KSTA 

KEND 

NDATA 


1 

1 

1001 

0 

0 

0 

0 

0 

IDIM 

: GRID 

SEGMENT 
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JSTA 

JEND 

KSTA 

KEND 

NDATA 


1 

1 
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0 

0 

0 

0 

0 
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GRID 

SEGMENT 

BCTYPE 
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I END 

KSTA 

KEND 

NDATA 


1 

1 

1003 

0 

0 

0 

0 

0 

JDIM 

: GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

KSTA 

KEND 

NDATA 


1 

1 

1003 

0 

0 

0 

0 

0 

KO: 

GRID 

SEGMENT 

BCTYPE 

ISTA 

I END 

JSTA 

JEND 

NDATA 


1 

1 

0 

1 

33 

1 

41 

0 


1 

2 

1005 

1 

21 

41 
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0 


1 

3 

0 

21 

33 

41 
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0 


1 

4 

0 

1 

33 
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0 
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ISTA 

I END 
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JEND 

NDATA 
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0 


MSEQ 
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01 

01 
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01 

01 

01 

01 
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01 

01 

01 

01 
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1 - 

-1 BLOCKING DATA: 








NBLI 

2 


NUMBER GRID : 

ISTA 

JSTA 

KSTA 

I END 

JEND 

KEND 

ISVAl 

ISVA2 

1 1 

1 

1 

1 

33 

41 

1 

1 

2 

2 1 

21 

41 

1 

33 

97 

1 

1 

2 

NUMBER GRID : 

ISTA 

JSTA 

KSTA 

I END 

JEND 

KEND 

ISVAl 

ISVA2 

1 1 

1 

193 

1 

33 

153 

1 

1 

2 

2 1 

PATCH SURFACE DATA: 
NINTER 
0 

PLOT 3D OUTPUT: 

21 

153 

1 

33 

97 

1 

1 

2 

GRID IPTYPE I START 
MOVIE 
0 

PRINT OUT: 

I END 

I INC 

JSTART 

JEND 

JINC 

KSTART 

KEND 

KINC 

GRID IPTYPE ISTART 
CONTROL SURFACE: 

NCS 

0 

I END 

I INC 

JSTART 

JEND 

JINC 

KSTART 

KEND 

KINC 

GRID ISTART I END 

JSTART 

JEND KSTART KEND IWALL INORM 
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After this test case is run, the convergence history, found in file cfi3d.res, should 
look like that plotted in Figure 9-24. The two sharp spikes in the residual history are at the 
iterations at which the grid levels change in the mesh sequencing procedure. 




c) drag coefficient history d) moment coefficient history 

Figure 9-24. Convergence histories for single grid F-5 wing case; 
a = 0.0 , = 0.95 . 
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9.2.3 Onera M-6 Wing 

In this case, a turbulent Navier-Stokes computation is performed over the Onera M-6 
wing, on a coarse grid, using a grid in PLOT3D-type format is performed. The grid con- 
sists of a single grid zone with a C-0 mesh topology and is composed of 41,225 points. 
(Keep in mind that one needs a grid at least double this size in each direction, e.g. 
193 x 49 x 33 or larger, to actually resolve the flow. A coarser grid is used here to shorten 
the test run.) The wing surface grid and wake, as well as the plane of symmetry grid are 
illustrated in Figure 9-25. The memory requirement for this example is 3.4 million words. 
A typical timing for this case is 453 CPU seconds on a CRAY YMP (NASA LaRC’s Sabre 
as of September 1996). 



Figure 9-25. Single zone Onera wing surface grid and plane of symmetry grid. 


The viscous direction in this PLOT3D-formatted grid is taken as the j direction rather 
than the k direction as generally recommended. (Due to the order in which CFL3D 
approximately factors the three index directions, the CFL3D code is usually most efficient 
when the primary viscous direction is taken as the k direction.) In this case, the conver- 
gence is not hurt by the altered directionality. (In some cases, however, it can be!) Note, 
however, that this case is more efficient (CPU timewise) when run on a vector machine 
with k as the viscous direction, due to the distribution of individual i , j , k index lengths 
and the way the code is vectorized. For this case, the difference on Sabre is a factor of 17% 
(with a CFL3D-type k viscous grid, the code runs in 374 seconds as opposed to 453 sec- 
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onds). It is possible to duplicate this result by changing the hard-wired parameter iplot3d 
to 0 in the form2bin.f file and using the input file oneram6. inp_cfi3d instead of 
oneram6 . inp_p3d. This exercise will demonstrate the differences between PLOT3D-type 
and CFL3D-type grids, as well as the corresponding differences in the input files. 

Besides the CFL3D code the following files are needed to run this test case: 


File 

oneram6 . inp_p3d 
m6_i97 . fmt_p3d 
form2bin . f 


Description 
input for CFL3D 
formatted grid 
grid converter 


The steps for running this case on the YMP are as follows: 


Compile the grid converter code: 

cft77 form2bin.f 


Step 2 

Link the grid converter object file: 

segldr -o form2bin form2bin.o 

Step 3 

Run the grid converter program to generate the 3-d volume grid (the binary file 

m6_i97 . grd_p3d will be output): 

form2bin 

Step 4 

Use the makefile to compile, link, and create the executable for the precfi3d code (be 
sure precfl ,h is in the current directory): 

make -f makeprecf 13d_cray 


Step 5 

Run the precf 13d code (the cflx.h files will be output): 

precfl3d < oneram6 . inp_p3d 

Step 6 

Use the makefile to compile, link, and create the executable for the CFL3D code: 
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make -f makecf 13d_cray 


Step 7 

Run the CFL3D code: 

cf!3d < oneram6 . inp_p3d 


The input file for this case is: 

I/O FILES: 
m6_i97 . grd_p3d 
plot 3dg . bin 
plot3dq.bin 
cf 13d . out 
cf 13d . res 
cf 13d . turres 
cf 13d . blomax 
cf 13d. outl5 
c f 13d . prout 
cf I3d. out20 
ovrlp . bin 
patch . bin 
restart . bin 


ONERA M6 Wing, plot3d type grid, coarse grid 


XMACH 

ALPHA 

BETA 

REUE, MIL 

TINF , DR 

IALPH 

IHIST 
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0 
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BREF 
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0 
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IS 

JS 

KS 

IE 

JE 

KE 

0 

0 

0 

0 

0 

0 

0 

0 
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IFLIM(J) 

IFLIM(K) 



1 

1 

1 

3 

3 

3 



IFDS (I) 

IFDS ( J) 

IFDS (K) 

RKAP0 (I) 

RKAP0 ( J) 

RKAP0 (K) 



1 

1 

1 
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GRID 
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NBC I DIM 
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NBCJDIM 

NBCK0 
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1 

1 

1 

3 

1 

1 

1 

0 
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BCTYPE 

JSTA 

JEND 

KSTA 

KEND 

NDATA 

1 

1 
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0 

0 

0 

0 

0 
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KEND 

NDATA 
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1 
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0 
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0 

0 

0 
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0 
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1 

1 
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0 
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JEND 
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0 

0 
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1 

0 
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02 

MITl 
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01 
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01 

1-1 BLOCKING 

DATA 


NBLI 

2 

NUMBER GRID : 

1 1 

2 1 

NUMBER GRID : 
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PATCH SURFACE DATA: 
NINTER 
0 

PL0T3D OUTPUT: 

GRID IPTYPE ISTART 
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MOVIE 
0 

PRINT OUT: 

GRID IPTYPE ISTART 
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0 
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0 
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KEND 
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0 

I END 
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KSTART 

KEND 
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JSTART JEND KSTART KEND IWALL INORM 


After this test case is run, the convergence histories, found in file cf 13d. res, should 
look like those plotted in Figure 9-26. The sharp spikes in the plots indicate the iteration at 
which the grid level changes in the mesh sequencing process. 
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9.2.4 Delta Wing 

The laminar flow over a 75° swept delta wing is solved in this test case. The grid con- 
sists of a single grid zone with 156,325 points. (Note that this grid is coarser than what one 
would normally use to resolve this flow.) The memory requirement for this example is 8.0 
million words. A typical timing for this case is 2236 CPU seconds on a CRAY YMP 
(NASA LaRC’s Sabre as of September 1996). The surface grid (k = 1 ) and a trailing 
edge grid plane are shown in Figure 9-27. 




Figure 9 - 27 . Single zone delta wing surface grid and trailing edge plane grid. 
Besides the CFL3D code the following files are needed to run this test case: 

File 

delta . inp 
delta . fmt 
f orm2bin . f 

The steps for running this case on the YMP are as follows: 

Step 1 

Compile the grid converter code: 

1 I 
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cft77 form2bin.f 

Step 2 

Link the grid converter object file: 

segldr -o form2bin form2bin.o 

Step 3 

Run the grid converter program to generate the 3-d volume grid (the binary file delta.bin 
will be output): 

f orm2bin 


Step 4 

Use the makefile to compile, link, and create the executable for the precfl3d code (be 
sure precfl .h is in the current directory): 

make -f makeprecf 13d_cray 

Step 5 

Run the precfl 3d code (the cflx.h files will be output): 

precfl3d < delta. inp 

Step 6 

Use the makefile to compile, link, and create the executable for the CFL3D code: 

make -f makecf 13d_cray 


Step 7 

Run the CFL3D code: 

cfl3d < delta. inp 


The input file for this case is: 

I/O FILES 
delta . bin 
plot3dg . bin 
plot 3dq . bin 
c f 13d . out 
cf 13d. res 
c f 13d . turres 
c f 1 3d . blomax 
cf 13a . out 15 
cf 1 3d . prout 
cf 13d . out 20 
ovrlp . bin 
patch .bin 
restart . bin 

75 Degree Swept Delta Wing - 37x65x65 - Laminar 

XMACH ALPHA BETA REUE , MIL TINF , DR IALPH IHIST 
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PRINT OUT: 
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NCS 

0 
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After this test case is run, the convergence histories, found in file cf!3d.res, should 
look like those plotted in Figure 9-28. 
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Troubleshooting 



Mistakes made in setting up a problem for CFL3D are (hopefully) diagnosed by the 
code’s error checks. The error messages, which are printed to unit 1 1 should be clear 
enough so that the user can easily identify and remedy the problem. This chapter contains 
a few general tips based on common user errors. 

Unfortunately, it is sometimes the case with CFL3D (as with any CFD code) that the 
code blows up, even though the user has apparently done everything right. For example, if 
the code tries to calculate a negative square root, it will bomb with a floating point error. 
What to do in such cases is never clear and is often more of an art form than a science. 
Listed below are some things to try and/or look for when experiencing difficulty with 
CFL3D (when it blows up for no easily-apparent reason). These limited suggestions for 
what to try when problems occur are based in part on the code-developers’ experiences 
and in part on what is heard from the user community: 

1. When the code gives the message “negative volume” or blows up (end-of-file) when 
trying to read the grid, check the following: 

(a) Be sure the grid is written correctly, using the right-hand rule (see “The Right- 
Hand Rule” on page 67) for both x, y, z and i, j, k . Either CFL3D format or 
PLOT3D/TLNS3D format may be used. See “Grid File” on page 65 for a descrip- 
tion of the two formats. Remember to set ngrid > 0 for CFL3D format and ngrid < 
0 for PLOT3D/TLNS3D format. 

(b) Check the grid near the point where the negative volume is indicated. Make sure 
there are no grid lines that cross or are positioned incorrectly. 

(c) When running on a workstation, be sure to use the necessary precision for arrays 
(many turbulent grids are too fine to use single precision). 

(d) Be consistent with the precision between the grid and the code (i.e., the grid must 
be created in double precision if the CFL3D code is “made” that way). 

2. Check the grid. It seems that 95% of the time, the problem is with the grid. Too much 
stretching too quickly, poor “quality”, badly-skewed cells, etc. can all cause problems. 
Also be sure that the grid and all its coarser levels are of a reasonable size (when using 
multigrid, a coarser grid level should not be too coarse). 

3. Be sure that the correct direction (either z or y ) is “up” according to the type of grid 
being used. See “Grid File” on page 65. 
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4. If problems occur when starting a run for a very large grid, debugging on a coarser 
grid is recommended. Unfortunately, running on a coarser grid level using the mseq 
flag still requires a large percentage of the full amount of memory. Because this can be 
frustratingly slow for very big grids, the use of the following tools, found in the Tools 
subdirectory (see “The Code and Supplementary Files” on page 9), is recommended: 
every otherp3d . f - reads a PLOT3D grid and writes out a coarser (every other grid 

point) grid 

v5inpdoubhai f . f - reads a CFL3D input file and creates a new input file applicable 

for either half or double the number of grid points 

After employing these tools to create a smaller grid and the corresponding input file, 
rerun precf 13d on the new input file and then recompile CFL3D and debug the prob- 
lem on the coarser grid. The required memory will be substantially smaller than that 
necessary for the original grid. 

5. Be sure to save a copy of the original code before making any modifications. If an 
error is made, the revision can be compared with the original version to aid with 
debugging. If additional subroutines are added, be sure they are added correctly to the 
makefile. If they are merely “tacked on” to the beginning of line 2 in the makefile, then 
they will not necessarily be recompiled correctly when cf n .h, etc. are changed. 

6. Peruse the output files early in the computation to make sure that they make sense. For 
example, if part of the grid is in motion, is it moving at the correct speed and in the 
expected direction? Do the results “look” as expected? Valuable CPU time can be 
saved by not running erroneous calculations for hundreds of iterations. 

7. Check to make sure the boundary conditions are implemented correctly. This includes 
all 1 -to- 1 and patched interfaces. For 1-to-l boundaries, look for “mismatch” in the 
output files for the “geometric mismatches” that may be a source of error. These num- 
bers should all be close to zero. Small mismatches may be acceptable, but large mis- 
matches (0(1)) most likely indicate that one of the segments on the block boundary 
has been specified incorrectly, or possibly backwards. For patched or overlapped inter- 
faces, it is quite a bit more difficult to assure valid communication stencils. Check all 
outputs from ronnie for patched grids and from MaGGiE for overlapped grids. 

8. Try lowering the CFL number significantly initially and allowing it to “creep” up as 
the solution progresses. Unless the grid is really bad, the CFL number should not have 
to be set below 0.1 (dt = -0.1). Sometimes it may be necessary to remain at low CFL 
numbers for particularly difficult problems. The optimum CFL number to run at is 
generally around 5 (dt = -5.0), for most problems on decent grids. 

9. Make sure the executable is appropriate for the input file, particularly if any changes 
have been made to it or to the grid since the previous run. Run precf 13d to make sure 
the dimensioning is correct in the cfl*.h files. If precfl3d changes them, CFL3D 
must be recompiled. 

10. Try employing mesh sequencing. Many people have found this to be beneficial for 
tough problems! For a description of mesh sequencing, see “Mesh Sequencing” on 
page 134. 
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11. Peruse all output files (there are a lot of them!) for any clues as to what might be 
wrong. 

12. Try restarting from a less difficult, converged case on the same grid. For example, run 
and converge the configuration at alpha = 0 first; then restart at the higher, more diffi- 
cult angle of attack (or Mach number or whatever). 

13. When really desperate, try running with first order in space for awhile (nitfo = ncyc), 
then restart with third order from that. Or, try using second order (rkapO = -1) rather 
than third order (rkapO = +0.333333). 

14. If multigrid is being used, try turning multigrid off for a short time. If multigrid is not 
being used, turn it on\ In general, for steady-state problems, multigrid should defi- 
nitely be used. See “Multigrid” on page 125 for instructions. 

15. Be sure to use the latest version of the code (as of November 1996, Version 5.0). 

16. There only seems to be sporadic success when varying idiag, ifds, or iflim. In general, 
if trouble arises when the default values are used for these variables, then trouble will 
occur even if they are altered. There are of course exceptions. For example, often 
hypersonic flow cases run more successfully with flux-vector splitting (idiag = 0). 
Also, sometimes, if a particular configuration is marginally stable (i.e., on the brink of 
going unsteady), then flux-vector splitting, which has more inherent dissipation than 
flux-difference splitting, may yield a steady solution while flux-difference splitting 
may go unsteady. What this means, however, is unclear, since it may be that the real 
physics of the flow should go unsteady. Presumably in such a case, if the grid is refined 
extensively, even flux-vector splitting should probably go unsteady. 

17. There is little recent experience with this, but experimentation can be made with ngam 
(type of multigrid cycle), mitL (number of iterations on each multigrid level), and 
mglevg (the number of multigrid levels). 

18. Another feature that is rarely used, but could be experimented with is residual correc- 
tion and/or smoothing with multigrid. Set issc and/or issr to 1. (Zero is the default.) 
These parameters have been known, in isolated instances (particularly for hypersonic 
cases), to cause a “bombing” solution to work. In fact, some users turn residual correc- 
tion and smoothing on as default. This is not recommended however because, for the 
majority of cases the code developers have seen, these parameters seem to hurt more 
than help. It probably depends a lot on the type of configuration or case being run. 

19. Try running a different turbulence model that is more robust (Baldwin-Lomax and 
Spalart-Allmaras are probably the most robust of the models). Then restart the case 
from this converged solution using the desired model. 

20. Monitor cf 13d. turres. Make sure there are either no or relatively few nneg values. 
Make sure the residual of the turbulent equations is not going up gradually over time 
rather than down. If there are problems, try setting factor lower in the appropriate 
turbulent model subroutine (such as subroutine spalart when using the Spalart-All- 
maras turbulence model). 

21. Sometimes the order of the indices in the grid can make a difference, since the code 
performs the approximate factorization (AF) in a particular order. Experience has 
shown that it is usually best to let the primary viscous direction (if there is one), such 
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as the direction normal to the wing surface, be the k direction. Eventually, at steady- 
state, the answer should be the same regardless of the inuex directions, but how well 
the code converges to the steady state can unfortunately sometimes be influenced by 
the choice. 

22. When restarting and switching turbulence models, it is sometimes necessary, at least 
temporarily, to lower the CFL number or time step to get the new solution going. After 
a time, the CFL number or time step may then be “bumped up” to the desired level. 

23. Hypersonic cases can often be difficult to start. Some suggestions are: 

(a) Start with a very low CFL number (on the order of 0.1) and run for a while, then 
later ramp it up. 

(b) Use mesh sequencing. 

(c) Use flux-vector splitting (ifds = 0), at least in the beginning. 

(d) Restart from a previous similar solution. 

(e) Experiment with varying mitL (number of iterations on each multigrid level). 

24. If the residuals near patched boundaries are high (particularly when the grid sizes are 
very different near the patch), try replacing calls to int2 with calls to int3 instead 
(int3 employs gradient limiting on the patch stencil). 
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The computational algorithm employed in CFL3D for the three-dimensional Navier- 
Stokes code CFL3D is described in Thomas et al. 37 The governing equations, which are 
the thin-layer approximations to the three-dimensional time-dependent compressible 
Navier-Stokes equations, can be written in terms of generalized coordinates as 

3Q . 3(F - f\,) . 3(G-G„) . 3(ft- ft.) „ 

3? 5| 3rf X, = 0 

A general, three-dimensional transformation between the Cartesian variables ( x , y, z ) and 
the generalized coordinated (£, q, £) is implied. (See Appendix F for details.) The vari- 
able J represents the Jacobian of the transformation: 

a(^,q,C,0 

J _ — (A-2) 

d(x, y, z, t ) 

In Equation (A-l), Q is the vector of conserved variables, density, momentum, and total 
energy per unit volume, such that 




j 

-j pv 
pw 


The inviscid flux terms are 


P U 

pUu + ^p 

J PUV + ^P 

P Uw + $ z p 
(e + pW-^p 
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P v 

pVu + r\ x p 
-j pVv + r\ y p 
p Vw + r\ z p 

(e + p)V-y\,p 




pW 

pWu + ^p 
pWv + ^ y p 
pWtv + £ z p 
(e + p)W-^ t p 


The contravariant velocities are given by 


U = ^ x u + t yV + 

V = r\ x u + T] y v + r\ z w + r\ t 
W = ^ x u + C,v + C, z w + 


The viscous flux terms are 


F 

f = — 

tv J 


^xx + ^y X xy + ^z X xz 


j ^x X xy + ^y X yy + ^z X yz 
^x X xz + ^>y X yz + ^>z X zz 
^>x^x + ^>yby + \z h Z _ 


^xx + ^xy + ^xz 


'j T\x'xy + Vw + 11 ^ 

T1 A Z + T W + T 1A Z 
nA + VA^A. 
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U tx*xx + ^>y^xy + ^z^xz 

= -J = J t x t xy + ^ y x yy + ^ z X yz (A- 10) 

^>x^xz ^y^yz ^z^zz 

. ? A + ?,», + 5 A . 

The shear stress and hear flux terms are defined in tensor notations (summation convention 
implied) as 


<lx = 


dU: dU:\ 

du, i 


dxj + a*J + 

(A-11) 



(A-12) 

AOi 

dc ? 


l Pr( Y-l) 

lr J 

dX; 

(A-13) 


The pressure is obtained by the equation of state for a perfect gas 

P - (Y-l) e- |(m 2 + v 2 + w 2 )J (A- 14) 

The above equations have been nondimensionalized in terms of the free-stream^ den- 
sity. Poo . the free-stream speed of sound, , and the free-stream molecular viscosity, jl^ . 

(See Chapter 4.) The chain rule is used to evaluate derivatives with respect to (x, y, z) in 
terms of (^, r\, £) . Consistent with the thin-layer assumption, only those derivatives in the 
direction normal to the wall (£) are retained in the shear stress and heat flux terms. Equa- 
tion (A-l) is closed by the Stokes hypothesis for bulk viscosity (X + 2p/3=0 ) and Suther- 
land’s law for molecular viscosity. 45 

The CFL3D code also has the capability to solve the Euler equations, which are 
obtained when the f 1 v , G v , and terms are omitted from Equation (A-l). 

The numerical algorithm uses a semi-discrete finite-volume formulation, resulting in a 
consistent approximation to the conservation laws in integral form 




[11 See the note on page 3 about the usage of the phrase free stream. 
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where f denotes the net flux through a surface S with unit normal n containing the (time- 
invariant) volume V. Integration of Equation (A- 15) over a control volume bounded by 
lines of constant ^ , rj , and C, gives the semi-discrete form 

(^} ' k + 1/2 <J’ k ~ ^~^v)i-l/2, j,k 

„ » ~ (A-16) 

+ (G ~G v)i,j+ \/2,k~('*-G v ) i j_ 1/2, k 

+ 1/2“ (ft - ^v)i ,j,k- 1/2 = 0 

where, for convenience, 

= ^>i+\/2,j,k~^i-\/2,j y k = 1 

AT 1 = \j + l/2,k~\j-l/2,k = 1 < A ‘ 17 > 

= £>i,j,k+l/2~^>i,j,k-i/2 = 1 

The discrete values Q, 7i * are regarded as average values taken over a unit computational 

cell; similarly, discrete values of £ , G , and H are regarded as face-average values. The 
convective and pressure terms are differenced using either the upwind flux-difference- 
splitting technique of Roe 31 or the flux-vector-splitting technique of van Leer. 39 The 
MUSCL (Monotone Upstream-centered Scheme for Conservation Laws) approach of van 
Leer 40 is used to determine state-variable interpolations at the cell interfaces. The shear 
stress and heat transfer terms are centrally differenced. 
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Time Advancement 



(B-1) 


(B-2) 


(B-3) 


where the superscripts indicate time level. When <|> = 0 the method is first-order tempo- 
rally accurate; when <j) = 1/2 the method is second-order accurate. This equation is 
implicit because the right-hand side is a function of the unknown flow variables at time 
level n + 1 . 


The CFL3D code is advanced in time with an implicit approximate-factorization 
method. The implicit derivatives are written as spatially first-order accurate, which results 
in block-tridiagonal inversions for each sweep. However, for solutions that utilize FDS the 
block-tridiagonal inversions are usually further simplified with a diagonal algorithm (with 
a spectral radius scaling of the viscous terms). 

Because of the method which the left-hand side is treated for computational efficiency 
in steady-state simulations (approximate factorization, first-order accuracy), second-order 
temporal accuracy is forfeited for unsteady computations. One method for recovering the 
desired accuracy is through the use of sub-iterations. Two different sub-iteration strategies 
have been implemented in CFL3D. The first method is termed “pseudo time sub-iteration 
(t-TS)”. The method is also often referred to as the “dual time stepping” method. The 
other method, termed “physical time sub-iteration (/- TS),” follows Pulliam. 28 


For the t -TS method, a pseudo time term is added to the time-accurate Navier-Stokes 
equations. 
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iao , n + <i>)(Q' l+ 1 ~q”) -^cq^-q" 1 ) = ^ 0 n+1 ) 

Jdx JAt 


This equation is then discretized and iterated in m , where m is the sub-iteration counter. 

(i + <n(Q m+ 1 -Q w )-<rn w -Q m ' 1 ) + (B . 5) 

J Ax 

( i + <t>)(Q m + 1 - Q n ) - <t>(Q” - Q” -1 ) = R(Q m+l ) 

JAt 

In Equation (B-4), <() and govern the order of accuracy of the physical and pseudo 
time terms, respectively. In practice, the pseudo time term is treated as first order (i.e., 
<j>'= 0 ), but the general form is shown here for completeness. As m — » <*> , the pseudo time 

term vanishes if the sub-iterations converge and Q m + 1 — > Q" + ' . If R is linearized with 

R(Q m + 1 ) = /?(Q m ) + |^AQ m (B-6) 

and the quantity — (1 + <}>)Q m / (JAt) is added to both sides of Equation (B-4)), then Equa- 
tion (B-4) becomes 

[(^ + !^> + *t A + 8 n B + *t C K- 

VAQ m ~ l 4>AQ” -1 (l+<t»(Q w -Q") , 

JAx JAt JAt 


where 


AQ m = Q m+1 -Q m 

4 


d(G-G v ) 




Equation (B-7) is approximately factored and written in primitive variable form; it is 
solved as a series of sweeps in each coordinate direction as 
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|Y( 1 + »')M ( 1 + 4>)M~j 5 A ,l Aq ' _ 

H J Ax JAl ) i J M 


(J/MAq™ 1 <j)MAq" 1 
JAx JAt 

(l+»)M(q w -q") m 
JAt KH ’ 


r- m + r)M + ( i+<D)M v i = f( i ±rm + ( i ± m \ q 

A JAx JAt J 11 J 4 l, JAx JAt ) 4 


r pnM + (M)MV 8ct l v = 

A JAx JAt J J 


(l+f)M fl+^)MV „ 


m a 1 m . m 

q = q +Aq 


where the primitive variables are 


9q 


A* = 


atf-fv) 


B* = 


8(G - G v ) 


C* ~ 


8(ft-ft v ) 


The quantity Ax is based on a constant CFL number set by the input parameter cfl_tau 

(See “LT5 - Time Step Parameters” on page 21). Multigrid is used to drive Aq m to zero in 
a reasonable number of sub-iterations. 


In the t-TS method. Equation (B-3) is merely iterated in m , where m is the sub-itera- 
tion counter: 
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(1 +4>)(Q m + 1 -Q n )-4>(Q”-Q , '~ 1 ) = R(0 m + ') 

JAt 


The quantity -( 1 + fy)Q m /(JAt) is added to both sides, the residual is linearized, and the 
equation is approximately factored and written in primitive variable form as 

[LLiilM + 8 , A *lAq' = - (1 + R( ») (B-22, 

L JAt ' J JAt JAt 

r< 1+ »> M + 5 _B *1 Aq" = ( 14 |>Ma,' <=•*, 

. JAt 1 J JAt 

5C ,1 a " = <i±l)M 4q " (B-24) 

JAt * J JAt 

ttl + 1 Tf\ i TYl m . 

q = q +Aq (B- 25 ) 


As m -> oo , q m + 1 -> q” + 1 . When only one series of sweeps is performed, q"‘ = q" and 
the standard time-accurate CFL3D scheme is recovered (i.e., no sub-iterations). Unlike the 
x-TS method, this sub-iteration procedure (Equation (B-22) through Equation (B-25)) uti- 
lizes only one time step: the physical time step At (= constant). 

Prior to the execution of Equation (B-25) in the code, the corrections are constrained 
in order to maintain the positivity of the thermodynamic variables p and p . For example, 
the update to pressure is taken as 


m n 


p n+x = p" + Ap 1 + <|) c a c + — P 

n 

l \ p 


whenever Ap/p n < Ct c . Currently, d c — -0.2 and 4> c — 2.0. 

In the limit of A p/p" -> -°o , p n + 1 -> p n / 2 . This modification improves the robust- 
ness of the method by allowing it to proceed through local transients encountered during 
the convergence process wh i c h would otherwise terminate the calculation. 

When running steady-state computations (dt < 0), the time step advanced locally in 
each cell is related to the input CFL number by 


At = 


IV^U, + |Vr||r 2 + |Vgr 3 
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where 


'l = M + a + 2|V^|(p + p r )max(|,^j^l 

L?t r 

h = |v| + a + 2| Vr|| (fx + fi r )max^, p^^~“ 
h = \W\+a + 2]VQ(ii + \L T )m^,^~-^ 


(B-28) 


where U = U/ |V^| , V = V/|Vrj| , W = W/\VQ and U, V, and W are defined in 
Equation (A-7) in Appendix A. The viscous scaling terms (the last term in each equation 
of Equation (B-28)) are only used when the solution includes viscous terms. They arise 
from a spectral radius scaling (see Coakley 14 ). 
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Spatial Discretization 


C.l Inviscid Fluxes 

The spatial derivatives of the convective and pressure terms are written conservatively 
as a flux balance across a cell as, for example, 

(5^F), = t i -t _i (c-i) 

' + 2 ' 2 

where the i index denotes a cell-center location and i + 1/2 corresponds to a cell-inter- 
face location. The interface flux is determined from a state-variable interpolation and a 
locally one-dimensional flux model. For flux-vector splitting (FVS), Equation (C-l) is 
split into forward and backward-moving pieces as: 

(5^F). = (5^F + + 5^F _ ) / = [^(qJ + rCq^l.^-trCq^ + rCq^)]. , (C-2) 

For flux-difference splitting (FDS), the interface flux is written as an exact solution to an 
approximate Riemann problem as: 

(SpF) = \ [F(q L ) + t(q R ) - | A inv | (q* - q L )] . , (C-3) 

— ^ [F(q^) + f'(q^) — |Aji, v | (q^ — q^)] j 
Z '"2 

Further details on the FVS and FDS methods are given below. In both cases, interpolated 
values q^ and q R at each interface are required. The state variable interpolations deter- 
mine the resulting accuracy of the scheme. They are constructed from interpolation of the 
primitive variables. For first-order fully-upwind differencing: 

(Qz.). , = q, 

, + 2 

(C-4) 

(q/f) , = q/ + i 

1 + 2 

Higher order accuracy is given by the family of interpolations: 
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(q L ) ! = q, + 7[( 1 -k)a_ + (1 + k )a + ]. 


(q*). , = q /+ i- 7 [(l -K)A + + (1 +k)AJ. 


where 

A + = q i + 1 -q ( 

(C-6) 

A_ = q,-q ( _i 

The parameter K€ [-1,1] forms a family of difference schemes, k = -1 corresponds to 
second-order fully-upwind differencing, k = 1/3 to third-order upwind-biased differ- 
encing, and K = 1 to central differencing. Note, however, that setting K = 1 in CFL3D 
will result in odd-even point decoupling, since there is no artificial dissipation in the code. 
Also note that “third order” for K =1/3 is only obtained for one-dimensional flows. For 
two and three dimensions, the formal order of accuracy is second order. 

In practice, the gradients of density and pressure are biased by an average value in 
order to improve the robustness of the calculation at higher Mach numbers and in the early 
transient stages of a solution. 


q ‘ + /+ 


q. - -A 

q, 2 


(q L ). , = q, + j[(l-K)A!! + (l + K)A*] t . 

' + 2 

(c-a) 

(q») , = q^i-^td-K^i + d+KjAh,*, 

'*2 4 

Note that Equation (C-8) is not performed for the gradients of velocity; this is essentially 
an extrapolation of the log of the density and pressure (first-order expansion). 


240 CFL3D User’s Manual 


I 1 I! 


C.1.1 Flux Limiting 


C.1.1 Flux Limiting 

For solutions with discontinuities (such as shock waves), schemes of order higher than 
one generally require a flux limiter to avoid numerical oscillations in the solution. CFL3D 
has several limiter options. 

The smooth limiter (iflim = 1) is implemented via 


( q z.). + i = q, + |^f(l - kj)A_ + (1 +K5)A + ] 


(q*) j = q, + 1 -^-[(l -K5)A + + (1 +K5)AJ 


where 


2A + A_ + e 
(A + ) 2 + (A_) 2 + e 


and e is a small number (e = 1 x 10 ) preventing division by zero in regions of null gra- 

dient. 

The min-mod limiter (iflim = 2) is implemented via 

i = q t + 7[(l -K)A_ + (1 +K)A + ],. 


(q*). , = q, + 1 - z [(l-K)A + + (l + k)A_],-. 


where 


A_ = minmod(A_, bA + ) 

A + = minmod(A + , bA_) 

minmodfx, y) = max{0, min[;t sign(y), bysign(jc)]}sign(x) 
The parameter b is a compression parameter, b = (3 - k)/( 1 - k) . 


The smooth limiter tuned to K = 1/3 (iflim = 3) is implemented as follows. 
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where 

(5 L q ),- = Kq ( + 1 -q fJ q ( -q,-i) 
(M), = i(q I -q ( _i J q J + i-q / ) 


(C-1 5) i 


I (x,y) 


■x(y 2 + 2e 2 ) + y( lx_ + £ 2 ) 
2x 2 - Ary + 2y 2 + 3e 2 


(C-16) 


and I is designed to recover the state variable to third-order accuracy in the one-dimen- 
sional case in smooth regions of the flow and interpolate without oscillations near discon- 
tinuities. The parameter £ is a small constant of order A.tr which is used to improve the 
accuracy near smooth extremum and reduce the nonlinearity of the interpolation in regions 
of small gradient. 


C.1.2 Flux-Vector Splitting 

The flux-vector splitting (FVS) method of van Leer^ is implemented as follows. The 

generalized inviscid fluxes t, G , and ft , representing the pressure and convection terms, 
are upwind differenced by splitting into forward and backward contributions and differ- 
encing accordingly. For example, the flux difference in the \ direction is 

8^F = 8^ + + 8^F“ (C-17) 

where 8^ and 8^ denote general backward and forward divided difference operators, 

respectively. For flux-vector splitting, £ is split according to the contravariant Mach num- 
ber in the ^ direction, defined as 

Mr = - (C-1 8) 

a 


where 



(C-1 9) 
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v = & + \ y i + 


For locally supersonic flow, where |M^| > 1 , 

F + = F #- = 0 M ^>+ 1 

F = F F + = 0 M ^<- 1 

and for locally subsonic flow, where |M^| < 1 , 


f m ^[U-U±2a)/y + u] 

|V£| ± p - 

" J fL»lU-V±2a)/y + v) 

fi m lkz(~U±2a)/l + w] 


energy 


where the direction cosines of the cell interfaces are 

£ - Jk_ £ _ Al £ 

S* — IC7£I S V lT7t| 


/Ls = ±t <m ^ ±1)2 


f~ = f 
J enersv 


energy ^ mass 


± _ ± [(1 -Y)f/ Z ±2(y- l)f/a + 2a 2 , (m 2 + v 2 + w z ) Tr 


(~U± 2a) (C-25) 


(y -i) 


£ 

For an implicit scheme, the Jacobians of the right-hand-side flux terms must be deter- 
mined (see Appendix B). They appear as terms in the left-hand-side matrix multiplying 
Aq , and the resulting system of equations is solved with a full 5 by 5 block-tridiagonal 
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inversion procedure. For flux-vector splitting, the split flux Jacobians (with respect to the 
primitive variables) for the E, direction, i.e. , are 

^pf 1 , t, > T . . 3 . .1 


^ = h D± 4- l± t v±a i 


5 -*£<’*«>«• 

5 “ *£<®*-*r 

S - *£<**«* 


5-3(P±.,[-.±l(l7± fl ,] 


w = ± i (P±a) [ll ( - p±a) MI; (p±a)TI II 

^ - ±^(r±a)[t(^(-P± a ) + 2 U ) + (£/± a) ] 

^ = ±£(P± a )4^ ( -P±<0 + 2«] 

g = ± £ ( r±<,)^(-t/ ± <o + 2 M ] 

^ = ±^(P±a)f4i2<,-^(-i/±a)±T«(lTJ-(D±a) 
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±\(U ± U ± a)i y + v^(f 7 ± a) T 1 

±£(t/±a)t^(-j7± a ) + 2vj 


±£(i/±a)p^(-r/ + a) + 2v)+(r/±«) 


= ±-p-(C/±a)|ji(-r/±a) + 2v 

4 a L Y 


±—J U ± a) | J 2 fl-^-(- U ± a)±yv( lT^(l/ + a) 


±£(!7±a)4^(-^±a) + 2w] 

±£( C7 ± «)ly[^(- f/ ± a) + 2wJ 

/V 

±£(Z7±a)[4^(-f7±a) + 2^+(r/±a)] 

±-^(Z 7 ± a) j|^ 2 a-|-(- Z 7 ± a)±y^l T t 7 ± a) 


± l( 0 ± o) {(- v±.M (j2. - &)--£-] ♦ 


[f ^* 1 


±£(y± a ) k[|2i + (-^ r ^)-f/±<.) + « J + v 2 + » 2 ] +U (t/± a ) 


y-1 vy + 1 y 


± £ ( ^ 1 + (fTT “ y)- ^ ± «) + « 2 + v 2 + h- 2 ] + v( t/ ± a) 


± £ ( ^ ±a) {K^ + (rfT" Y'](-^±a ) + « 2 + v 2 + H' 2 J + H' ( C/ ± a) 
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+ -b v± a) {[(y+r - t)( 2 ° 4 a (-v± a) y^-(u±3 a) 
+ lMr^ v±a)± ^} 


C.1.3 Flux-Difference Splitting 

In the flux-difference splitting (FDS) method of Roe 31 , the interface flux in the 
direction is written ] 

j 

t i = Jl^q^ + ^q^-lAinvkqjj-qi.)] i «^ 2 > j 

1 + 2 * 2 i 

| 

where A mv is A inv evaluated with Roe-averaged variables defined below. (A inv is the 
inviscid part of the A matrix defined in Appendix B.) Hence, 

I 

|A inv | = |Aj (q)| (C- 33 ) ! 

* 1 i 

| 

] 

j 

(C- 34 ) j 

The diagonal matrix A is the matrix of eigenvalues of A inv , T is the matrix of right ! 

eigenvectors as columns, and T" 1 is the matrix of left eigenvectors as rows. They are all j 

evaluated at Roe-averaged values such that ! 

■ 

= Ainv(Q*-Qr.) (C- 35 ) j 

is satisfied exactly. The term lAjnvIfQ^ - Q L ) can be written 


q = q(qL>q*) 

A 

A inv = = TAT 1 = T(A + + A )T 

A ± = A ± 1 A| 

2 

AjJ = TIM!- 1 
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Ai„v|( Q* Q L ) = A inv AQ = 


ua 4 + i x a 5 + a 6 
va 4 + | y a 5 + a 7 
vva 4 + | z a 5 + a 8 

-2 

- p _ _ _ a a, 

t 4 + ( U - q,)a 5 + «a 6 + va 7 + wa 8 


where 

«,-|3iDirAp-ff) 

J v a ' 

a 2 = YJs |t7 + a|(Ap + paA(7) 

2 a J 

a 3 = — — r | U - a\ (A p - paAC/) 

2 5 J 

a 4 = a, + a 2 + a 3 

a 5 = a(a 2 -a 3 ) 

a 6 = B|t7|(pA«-| x pA!7) 

a-j = YA | Z/| (p Av - 4>>pAt7) 

a 8 = YA |j/|(pAw-| z pAt/) 

Here, the notation ~ denotes the following Roe-averaged evaluations: 
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i 



a 2 = (y-l)H- 


- 2-2 -2 
u + v + w 


(C-38) 


The terms | z , and ^ are defined in Section C.1.2 and 

V = |^i + 5/ + $,* + $,) <«•> 

For flux-difference splitting, the true Jacobians are expensive to compute. Two alterna- 
tives are employed in CFL3D. When the system of equations is solved with a full 5 by 5 
block-tridiagonal inversion procedure (idiag = 0), the following approximations for the 
left-hand-side flux-difference splitting Jacobians are employed: 

( A invX , 1 = 9 ( A inv)j + l A >n v l • . ll 
, + 2 L 2 J 

(C-40) 

( A inv). 1 ” 2 ^ A inv) ( + i _ l A «nv| l| 

Flux-difference splitting also has an option to employ a diagonal approximation for the 
left-hand side (idiag = 1). In this method, each of the spatial factors is approximated with 
a diagonal inversion as 

G® + 8 ^i] AQ * T br< + + 5 i A 1 T '’ AQ (cj,) 

Because of the repeated eigenvalues of A , only three scalar tridiagonal LU decomposi- 
tions are needed in each direction, resulting in a significant savings in run time. 


I 


i 
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(C-44) 


Implemented in a finite-volume approach, Equation (C-43) requires an approximation to 
the volume at the cell interface (1/ J) i+ 1/2 , which is calculated by averaging the neigh- 
boring values. 


When the system of equations is solved with a full 5 by 5 block-tridiagonal inversion 
procedure (idiag = 0), the viscous Jacobians (left-hand-side implicit terms) are employed 
only for the viscous terms in the C, direction (corresponding with the k index of the grid). 
This is a hold-over from the early days of the CFL3D code, when viscous terms were 
employed in only one direction. Hence, keep in mind that if the idiag = 0 option is used 
when viscous terms are included in either the j or / directions, the convergence may suf- 
fer due to the lack of the appropriate left-hand-side terms. The missing left-hand-side 
terms have no effect on converged solutions, however. 
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However, almost all runs with CFL3D employ flux-difference splitting with the diago- 
nal left-hand-side option (idiag = 1), because flux-difference splitting is generally more 
accurate for Navier-Stokes computations (see van Leer et al 41 ), and idiag = 1 is signifi- 
cantly less expensive than idiag = 0. For the diagonal method, a spectral radius scaling for 
the viscous Jacobian matrices is used, similar to that developed by Coakley. In this refer- 
ence, the true left-hand-side viscous matrix term is replaced by the matrix vl , where I is 
the identity matrix, v = £t max /p , and p max is the largest eigenvalue of the one-dimen- 
sional Navier-Stokes equation, p. max = max(4p./3, yjx /Pr ) . In CFL3D, nondimensional 
M^max is taken as 2(1 + p.,), where [i ( is the nondimensional turbulent eddy viscosity. 


I IM 
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Multigrid Algorithm 


The full-approximation storage (FAS) multigrid algorithm is used to accelerate con- 
vergence to steady state (or to accelerate convergence of sub-iterations during a time-accu- 
rate computation). A sequence of grids G 0 , G,, ..., G N is defined, where G N denotes the 

finest grid, and coarser grids are formed by successively deleting every other grid line in 
all three coordinate directions. The fine grid serves to damp the high-frequency errors; the 
coarser grids damp the low-frequency errors. The coarse grids are solved with a forcing 
function on the right-hand side, arising from restricting the residual from the finer meshes. 
The forcing function is the relative truncation error between the grids, such that the solu- 
tion on the coarser meshes are driven by the fine grid residual. The resulting scheme on 
mesh G ( is given as 

N,Aq^ = -[L,.(q- ) - X,] = -R j (D -i) 

where q^ is the current approximation to the solution on mesh G, , N ( is the spatially- 
factored implicit matrix, and X- is the relative truncation error (where x N is defined to be 
zero). The relative truncation error is calculated as 

T ( . = Z,.(/' +] q' +1 )-/' + ,fl ( + 1 (D-2) 


The operator l\ + , is a volume- weighted restriction operator that transfers values on the 
finer grid to the coarser grid 



i+ 1 



(D-3) 


where the summation is taken over the eight finer grid cells that make up the coarser grid 

cell. The restriction operator / ■ + ] represents a summation over the finer grid cells which 
make up the coarser cell 
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The corrections V, on the coarser meshes are used to update the finer mesh 

C T i c 

where the prolongation operator corresponds to trilinear interpolation. 

When correction smoothing (issc = 1) is employed, the corrections V- are smoothed 
on G, , before prolongation, with a Laplacian-type operator factored into three sweeps. 
Equation (D-5) is replaced with 

V, = 

(/-e^8^)(/-e^8 TfT1 )(/-e^8^)V J = V. 


The e£, , and coefficients are user-input values. When used, typical values are 0.3. 

The correction smoothing overcomes an odd-even decoupling sometimes encountered 
with the FAS algorithm on highly-stretched grids. 

When residual smoothing (issr = 1 ) is employed, the same Laplacian-type operator is 
used to smooth the Aq^ values, just prior to updating the primitive variables on a given 
grid level, 

(7 - eJ 8 k )(7 - <8^(7 - = Aq? (D-7) 

The e£ , e' , and e£ coefficients are again user-input values. When used, typical values are 
0.3. 
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Primitive Variables 



While CFL3D solves the governing equations in conservation law form, only the prim- 
itive variables are stored in permanent memory. This necessitates the use of the transfor- 
mation matrix: 


where 



Q-[ 

*1 = [p u v w p\ 


p p u pv pw e 

T 


From Equation (A- 14), 


Therefore, 


e = — r + §(« 2 + v 2 + w 2 ) 
Y — 1 2 


M = 


2e 

9p 9 m 
9pM 9pM 
9p 9 m 
9p v 9pv 
9p 9 m 
9pw 9pw 
9p 9 m 
de de 
9p 9 m 


9v 9w 9 p 
9p M 9pM 9pM 
9v 9w 9 p 
9pv 9pv 9pv 
9v 9w 9 p 
9pw 9pw 9p w 
9v 9 w 9 p 

de de de 
dv 9w dp 


1 

M 

V 

W 

2 2 2 
M + V + W 


0 0 0 

poo 

0 p 0 
0 0 p 

pM pv pw 


0 

0 

0 

0 

1 

Y- lj 


The inverse of M is 


(E-1) 


(E-2) 

(E-3) 


(E-4) 


(E-5) 
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Generalized Coordinates 



F. 1 Navier-Stokes Equations in Cartesian Coordinates 


The compressible three-dimensional Navier-Stokes equations, excluding body forces 
and external heat sources, in Cartesian coordinates are 


+ ^ + + - n 

Bt Bx By Bz 


(F-1) 


where 


P 


Q = 


pw 

pv 

pw 

e 


(F-2) 


pw 

pit 2 + p - x xx 

P«V-T^ 

puw-X xz 

(e + p)u - ux xx - vx xy - wx x , + q x 
pv 

P UV ~ X xy 

pv 2 + p-X yy 
pvw—X yz 

(e + p)v - ux xy - vX yy - wx yz + q y 


(F-3) 


(F-4) 
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pw 

PUW-T XZ 

pvw - x yz 

pw 2 + p-T zz 

(e + p)w - uX xz - vX - w\ zz + q z 


_ ^ dv 9w 

z xx 3 ^ ^ 3 Z 

2 ( 0 dv 9 m 9 vv 

x yy = 3T %~dx~ dz 


- ^ _ du dv 

t « " 3T dz~dx dy 


(du dv 
x *y ~ ^Uy dx 


(dw du 

T « = “tar + Tz 


(dv dw'] 

= ^55 + 9yJ = T - 

The pressure is defined by the equation of state for an ideal gas: 

p = (Y - 1)^ - 2^ m2 + v + w )J 


F.2 Transformation to Generalized Coordinates 
Now apply the generalized coordinate transformation 

£ = \{x,y,z,t) 
q = r|(*, y, z, t) 

C, = £,(x,y,z, t ) 


From the chain-rule for a function of multiple variables. 
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3 _ - 3 3 r 3 3 

Wx “ ^ + 11 ^3r| + ^3^ + ^37 

3 c 3 3-3 3 

3y = ^ + ^ + ^3C + ^37 

3 _ p 3 3 - 3 3 (F ' 14) 

3z ^5? ^3 ti ^3; + f *57 

3 -33 -3 3 

57 = ^ ^3ii ^ + /, 57 

where % x , , t , x , § y , ^ , \ z , T] z , ^ , \ t , r|, , £, are the metrics. 

FI 2. 7 Obtaining the Metrics 

The metrics are determined as follows. (For a description of the geometrical evaluation 
of the metrics, see “Geometrical Evaluation of the Metrics” on page 263.) The derivatives 
of the generalized coordinates can be written 

d\ = % x dx + y dy + \ z dz + £ ,dt 
dx\ = r\ x dx + r\ y dy + \\ z dz+r) t dt 

d C = C x dx + + ^t dt (F 15) 

dt = t x dx + + t z dz + t,dt 

or, in matrix form (noting that t x = t - t z = 0 and f, = 1 ), 

4 ] [«* 4 , 4 , 4,1 \ dx 

dr \ = rfy 

<*4 4 , 4 , 4 , 4 , * 

-*J [0 0 01 L*. 

Similarly, the derivatives of the Cartesian coordinates can be written 

dx -*ti -*5 x i dt, 

dy = rfn (F . 17) 

^ *n *<; z, d s 

- d{ l [0 0 0 1_ L* 

Therefore, it is evident that 
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4 , 4 , 4 , 4 , 
n, n, \ n, 

4 , 4 , 4 . 4 , 

0 0 0 1 


^ X T1 X t 

^ ?T, ^ ^ 

Zj: Z-p Z C Z, 

0 0 0 1 


To determine the inverse matrix represented on the right-hand side of Equation (F-18), 
first the cofactor matrix is found to be: 

0 

(x&- x l*0 ~( x ^h~ x n z 0 0 ( F-i9) 

( x S?r\- x r\ y 0 0 


where 

CF 41 = 

cf 42 = x t (y%z$-y&) + yt( x &~ x ¥0 + z >( x $ y <*~ x t y 0 
CF 43 = - x^y^- y^) - y t ( x ^z^- x^) - z^x^y^- x^y^) 

The transpose of the cofactor matrix (i.e. the adjoint matrix) is 

(>\i^ - ~( x n^ _ x ^t|) _ ^^41 

-(y$z$- y^z) (x^-x^zz) -(x^y^- x^yz) cf 42 

(>^n — _ ^^43 


The determinant of the inverse matrix represented on the right-hand side of Equation (F- 
18) is 


^ Xt- X t 

y\ *, y^ y, 

^T| Z t^ Z l 
0 0 0 1 


= *$(VS - + x ^ z r\ - y^ z 0 


The Jacobian of the transformation is defined to be 
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Sx ^ z>t 

j = Mlill L H x % ^ Tl, 

3<W '° ~ ^ CyCjC , 

0 0 0 1 

Therefore, 

x % x, 

y% ^ ^ 

Z T) ^ Z t 

0 0 0 1 

Note that CF^ = 1/7. Now, from the property of an invertible matrix D , 

D " - sm**™ 

let 


I = d(*, Zi z > Q. 
J 3 ( 4 , 11 ,;,/) 


(F-23) 


(F-24) 


(F-25) 
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Z, x = J(y^-y^) 
ky = 

= ^(VrVn) 

= — x Ax~ yAy ~ 
ti, = J(y^-y^) 

^ = j(X^-X^) 

T 1 Z = J(x^-x^) 

T| f = ~ X t^\x~ y^y~ 

z>x = 

Cy = JiX^-X^) 

C z = Jix^-WO 

Cf = — Xf^x — y &y~ Z&z 


(F-28) 


F.2.2 Applying the Transformation 


Now, to apply the transformation to the Navier-Stokes equations represented in Equa- 
tion (F-l), substitute Equation (F-14) into Equation (F-l) and multiply by \/J : 


13Q 13Q, 13Q + ld_Qr + 

j dt Jd^‘ JdT} % Jd ^ 1 

iaf laf, , i ar A idf r 

JTt tx + Jd& Jdr\^ x ~Jc>£ x 

i3g + I^i £ +i^C + 

Wt y Jd£y Jdr^y Jd^y 
I3h, . l§ht Ijto- =0 

Jdt‘ z + JdZ^ z Jdr\^ z /aC 2 


(F-29) 


(Remember, however, that t x = t y - t z — 0 ). Since 



^af 
+ ya^ 


.(F-30) 


Then, 


^af _ 

7al " a IK'j) l dz\j) 


(F-31) 


So, Equation (F-29) becomes 


I Hi 
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Consider the fifth major term in Equation (F-33): 

Jj(y) = Jj( WW* = y&A + (F ' 34) 

0^(y) = + = y% z ^ + 

The summation of the terms in Equation (F-34) is zero. The same can be shown for the 
sixth, seventh and eighth major terms in Equation (F-33). Therefore, Equation (F-33) can 
be written 
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lifi + U^ x+g ^ +h ^ +Q ^ ) \ ™ 

+ ^ j( f ^ + g^ + h ^ z + Q^)] = 0 

When summed, the expression in the second major term in Equation (F-35) can be written 

p U 0 

P Uu + p$ x Z, x x xx + Z, y x xy + ^ z x xz 

f \ x + & y + = p Uv + p\ y - \ x x xy + \ y x yy + \ z x yz (F-36) 

P Uw + p$ z $ x X xz + $ y X yz + ^ z x zz 

{e + p) U-^jPj [ \ x b x + \ y b y + \ z b z _ 

where 

U = % x u + % y v + ^ (F-37) 

^ + vX ^ + wx « + ix 

by = UX xy + VX yy + WX yz + q y (F-38) 

b z = ux xz + + WT ZZ + iz 

Equation (F-38) can be written compactly using indicial notation as 

b x, = u j x x iX -ix, < F39 > 

with i = 1 , 2, 3 and j = 1,2,3 where 1 indicates the jc direction, 2 indicates the y 
direction, and 3 indicates the z direction. 
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F.3 Navier-Stokes Equation in Generalized Coordinates 
Now, let 

0 

texx + tyxy + texi 

F v = £>x X xy + t>y X yy + ^z X yz 

&xz + *>y*yz + &zz 
SA + \y b y + t>z b Z _ 

Combining the other terms in a similar manner and letting Q = Q/J , t = F/J , 

= F v /7 , G = G/J , G v = G v / J , ft = H/J, ft v = H V /J , Equation (F-35) can 
be written 

3Q , 3(6-6.) „ 

a7 + — 5? — + — 3Ti — + — a? 0 ,M, > 

The terms are as shown in Appendix A, Equations (A-3) through (A- 14). 


pu 

p Uu + p^ x 
F = P Uv + pS, 
p Uw + p^ z 
(e + p)U-$ t p 


F.4 Geometrical Evaluation of the Metrics 

By analogy with the integral form of the equations, a geometrical interpretation of the 
metric terms can be made. The vector Vk / J is the directed area of the cell interface nor- 
mal to a k = constant coordinate direction (k = £, T| , or £). (See Figure F-l.) The unit 
vector (k x , k y , k z )/|Vk| is composed of the direction cosines of the cell interface and 
|Vk|/7 is the area of the cell interface. Note that 

Vk = k x i + k y j + kjc 
|Vk| = 

The directed areas are calculated as one-half the vector product of the two diagonal vec- 
tors connecting opposite vertex points of a cell face, taken such that the directed area is 
parallel to the direction of increasing k. 

Likewise, the normalized contravariant velocity, U = U/ |V%| , for example, repre- 
sents the relative velocity normal to a ^ interface, where = -£, f /|V^| is the grid 
speed normal to the interface. The volume of the cell is 1/7 and is determined by sum- 
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Figure F-i. Directed area schematic. 

ming the volumes of the six pentahedra forming the hexagonal cell. Each pentahedron is 
defined by one of the six cell faces and the average point in the volume. The net effect is 
that the difference equations are satisfied identically when evaluated at free-stream condi- 
tions on arbitrary meshes. 

In the code, the metric arrays are set up as follows using the % direction as an example. 


A. 

si ( j , k, i , 1 ) = = £, x 

= x component of unit normal to i face 

si ( j , k, i , 2) = = hy 

= y component of unit normal to i face 

si ( j , k, i , 3 ) = 4/lV^I =|z 

= z component of unit normal to i face 

si ( j ,k, i, 4) = |V $|/ J 

= i face area 

si ( j ,k, i, 5) = -k/m 

= i face normal velocity 
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G. 1 Forces 


The forces are calculated in CFL3D as follows. Let F/ be the total dimensional force 
acting on the surface element l , with area s ( , normalized by qjs ref , where 





(G-1) 


ant ^ ~ s ref ’ s reference area. In what follows, ~s re j and s t are taken in terms of grid 
dimensions. Then the dimensionless force (force coefficient) acting on element l is 





Qoo^ref 


(G-2) 


F/ is composed of pressure and viscous components, Ff and F/ , respectively. The total 

force coefficient is computed by summing the contributions from all specified surface ele- 
ments: 



(G-3) 


G.1.1 Pressure Component 


+ P 

F / is normal to the surface. 


Kef F" 


- ■> 
5,n 


P-P c 


1- k - 7 l2 J ' 

2 P~|V 


= 2 




|V| l/a. 


-s ; n 


= 2 


1 

p y~ > 


(G-4) 


Therefore 
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- t- p 2 , , » 

s rer F/ = T(YP-l)5/n 


The x, y, and z components of f[ are obtained by multiplying Equation (G-5) by the 
appropriate direction cosine. For example, if element / lies on an i = constant surface, 

n = V| <«> 

S refill )x = -^2(YP-1)5/|x 

yAC 

5 re/( F ^)>' = -^-(YP- (G-7) 

~s ref (*i ) Z = (YP-1)S& 

YAY„ 

where V^| , and = ^/|V^| . 


G.1.2 Viscous Component 


F i is tangential to the surface. 


->V X - 'C/(Poo«oo). 2 >- 

5 " /F ' = p^I I,= Ivli/ai *' = if*' 


Consider the flow near a surface element I of an i = constant surface. (See Figure G 1 .) 



Figure G-i. Viscous force component example. 
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In the figure. 


= velocity vector 

= normal velocity vector 

= tangential velocity vector (0 on the surface) 


-» -» -> 

Vt = V-Vn 


-9V t ~ c 

^35 =^ 


afv-Vn 


where 


Vn = V-n 


' "7 • , v 

(V-n is the normalized contravariant velocity and n is the unit surface normal.) The x 

. r > • > >. 

component of x/ is T/ • i : 


afv- r-Vn i 


— 1 1 L v 


Similarly, 


(t/)v = A- 


) v-p- n 


; alWv-i^' 


Consider the nondimensionalization of the x component of x/ : 
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, &0x 

(*l)x = T 


ar«-fv 


*w 


- -2 - -2 

Poo^oo Poo^oo 


(See Equation (G-8).) Then 


> _ |V|- P 

pJv|-l s a - 


d(n/L K ) 


Therefore, 


,> x M ~ a[ M -(V -njicl 
(X/) * ' /?<?.- H an 

l r 


with similar expressions for (T/) y and (x,) z . The derivative is evaluated using the cell-cen- 
ter and wall values of a cell volume like that shown in Figure G-2. 



volume of cell = v. 


surface area = s 


An = J- 


Figure G-2. Cell volume example. 


That is, for the x component, 


[«-[v n^l -0 


where the subscript c denotes the cell-center value and [w - (v • = 0 on a solid 


wall with the no-slip assumption. So 
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(G-20) 


(G-21) 


(G-22) 


(G-23) 


G.2 Moments 


The moments due to the forces acting on an element are determined as follows. Let 


-» -»p -»v 

(F l) x = (F, + F/)j 


(F I)y = (F / +F ,) y 


-> ->v 

(F/)z = (F / +F/) 2 


(G-24) 


Figure G-2 illustrates the directions of the moments. All moments are positive if counter- 
clockwise when viewed from the positive axis. The conventions (assuming x points down- 
stream and z points up) are 


M x : rolling moment; positive for counter-clockwise roll when viewed from downstream. 
M y : pitching moment; positive for pitch up. 

M z ’. yawing moment; positive for counter-clockwise yaw when viewed from above. 
Therefore, 
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me (moment center) 

Figure G-3. Moment directions. 

{Mi)x = [+(Fi)x(.y a ~y mc )-(Fi)y(z a -z mc )]/b re f 

( Ml)y = [ -(fl)z(x a -x mc ) + (Fi) x Cz a -z mc )Vc ref (G ‘ 25) 

( Ml)z = [+(F/Mx a -i mc )-(F/)x(y a -^ mc )] / ^e/ 

— > _ < — y 

Note that the reference length used to nondimensionalize ( Mi)y is c re j , while (Mi) z is 

made dimensionless with b re f . This is the default for CFL3D-type grids or PLOT3D-type 

grids with ialph = 0 (see “LT3 - Flow Conditions” on page 19). However, if a PLOT3D- 

^ ^ 
type grid is used with ialph = 1, then ( Mi) y is made nondimensional with b ref and (Mi) z 

is made dimensionless with c re j-. ( Mi)x is always made dimensionless with b re f. By 
switching the reference lengths based on ialph, the moment coefficient that is normally 
associated with the pitching moment is always based on c ref , while the moment coeffi- 
cient that is normally associated with the yawing moment is always based on b ref . 
Because ( Mi) x always uses b re f, the moment coefficient associated with the rolling 
moment is based on b re j . 
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CFL3D has several turbulence model capabilities. Appendix H provides the derivation 
for the advanced turbulence model equations. Be aware that while some variables in this 
appendix are consistent with the rest of the manual (and are listed in the Nomenclature 
section), many are introduced, defined, and used only in these sections and may or may 
not appear in the Nomenclature fisting. Also, for simplicity’s sake in this Appendix, 

Re = Re- . 

l r 


H.l Equations of Motion 

Following Wilcox 46 , Favre 19 averaging can be used with the Navier-Stokes equations 
to account for turbulent fluctuations. The resulting equations of motion can be written 
using the summation convention as follows. The full Navier-Stokes equations are shown 
here, but in CFL3D, they are solved as the thin-layer approximation in pre-selected coor- 
dinate direction(s). The ~ indicates a dimensional quantity. 

if +5 t(p>v> = ° ,h.„ 

^(p5,) + ^-(p5/,.) = -^ + ^ <«> 

J^P^ + ^P^H) = + (H-3) 


where 


p = (Y - 1 ) pE-ip(« 2 + v 2 + vv 2 )J 


~ - 1.-2 -2 -2 
E = e + -(m + v + w ) 


H = E + £ 
P 
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- __ 1 (ft, At 

~ y - 1 vPr + Pr jJdxj 


a 2 = ¥ 


Note that the kinetic energy of the fluctuating turbulent field k is ignored in the defim- 

~ 1 -2 ~2 ~ 2 

tion of E in CFL3D (it is assumed that k « e + -(« +v + w)). Define 


_ 1 

* ij ' 2ydxj + dXj, 

W..-1 PiiJh 
11 - 2 VdXj dXi 


Also, the magnitude of vorticity is 

Q = 

The shear stress terms is composed of a laminar and a turbulent component as 

-L -T 

= % + X(/ 


where 


-L .-(z l 3 «ko 

T ij - 2 K S ” 3dx^j 


For all eddy-viscosity models in CFL3D, the following approximations are made: 

T J = 2 At(Sv-3 j^ 8 y) 


V, = o 


Currently, for the nonlinear models in CFL3D, 
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2v T K^(S lk W kJ -W lk S kj )- 

2 AT^2|(s,*S* y -is* / S M 8 l7 l 


M^Dt 


where k/ e is replaced by 1 / co when the k - co equations rather than the k - e equations 
are employed. 

The Navier-Stokes equations are nondimensionalized and written in generalized coor- 
dinates, as described Appendix F. For eddy-viscosity models, the end result is that the tur- 
bulent Navier-Stokes equations are identical to the laminar equations with the exception 
that 


p is replaced by p + p T 


is replaced by -^- + -^- 
Pr v 3 Pr Pr-r 


where p T is the eddy viscosity value obtained by whatever turbulence model is used, and 

Pr = 0.72 , Pr T = 0.9 . For the nonlinear models, both the above substitutions must be 
made and the following additions as well. The term 


- ^pk8 i7 + 2p T tf, - W,*S*,) - 2p T *4( SttStf-iSwSttS,. 


is added to t j7 in the momentum and energy equations and 


d [f - fi-T^dk 


is added to the energy equation. These additions are made in subroutines gf luxv, hfluxv, 
and ffiuxv. 
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H.2 Nondimensionalizations 

The turbulence equations are nondimensionalized by the same reference quantities as 
the Navier-Stokes equations: p M , (L , and L R = L/L ref . The nondimensionalized 

variables used with the turbulence models are: 


k 

Poe® 


- -2 

~2 

W = —2 


Pk Lr 

a oo 

Poo«oo 

Pk ” 

~ -2 




P~«e 


0 - -2- 


- - 2 

- -4 

Poo^oo 

Poo 

s 

II 

- -2 

_ u 

P = A> 


Poo«oo 


Poo^oo 


p A 



Pr. = 


X 

I x 

E 

~ ~4 


p = 


Poo^oo 

” Lr 





_ 

n = 


Me 

1 ” L R 


oo 


H.3 Zero-equation Models 
H.3.1 Baldwin-Lomax Model 

(ivisc = 2) 


The Baldwin-Lomax 10 model is not a field-equation model; it is an algebraic model. 
Because it is the original model employed in CFL3D, its implementation differs in many 
respects from the more advanced models. First of all, it does not use the minimum distance 
function as its length scale, like the other models. Instead, it uses a directed distance from 
the i = 1 , j = 1 , k = 1 , i = idim, j = jdim, or k = kdim point along a constant index line. 
For example, if the “body” is at k = 1, then the directed distance to a given point in the 
field is the directed (normal) distance from k given to k =1, keeping i and j fixed. See 
Figure H-l(a). The directed distance is 

d = r k • n - r 0 • n ( H * 18 ) 

where 7 k is the vector from the origin to k given and r 0 is the vector from the origin to the 

k = 1 point. Note that if grid fines curve significantly d can become negative as in 
Figure H-l(b). If the grid fines do this, CFL3D currently does not allow the distance to go 
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negative. Instead, it computes d out to its maximum, then sets all distances thereafter to 
that maximum value. However, if the grid behaves like the grid in Figure H-l(b), the Bald- 
win-Lomax model, which is inherently dependent on the grid structure, is probably not a 
good choice anyway. The use of any of the other field-equation models is recommended 
instead. 
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Since it now appears to be fairly widely accepted that the definition of y for the 
damping term needs to be modified in Baldwin-Lomax to give better answers when there 
are large temperature gradients near the wall, 

(H . 22) 


is used rather than 


+ VpX - 
y = — —y 

Pw 


Nondimensionally, this becomes 


i 

Jp%, ( Re V 




The outer eddy viscosity is 


Pt, outer ~ 


where 


2 

F wake = mi nlymax F max’ l0 y m ax U dif /F max^ 

F(y ) = yQ[l - exp(-y + /26)] 


In wakes, exp(-y + /26) is set to zero. F max is the maximum value of F(y) that occurs in 
a profile and y max is the value at which F max occurs. Also, 

. r, . c <fo wfr' 


^ = [i +5 - 5 (p)] 

L ^ max' - 1 


u dif = (^m 2 + v 2 + w 2 ) max -('Ju^ + v" + w ) min 

The second term in u Aif is taken to be zero, except in wakes. The region for the search for 


2 2.2. 


F is currently bound by 

max * 


0-2B mflX +1<1 1 <0 - 8T W +1 
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where T| , in this case, is the index direction away from the body. 

H.3.2 Baldwin-Lomax with Degani-Schiff Modification 
(ivisc = 3) 

The Degani-Schiff 16 modification to the Baldwin-Lomax model is an algorithmic 
change which attempts to select the first occurrence of F max in a search from the wall out- 
wards. This can be important when there is a vortex somewhere above the body surface. If 
the code is not forced to select the F max in the boundary layer, it may choose a length 

scale corresponding to the distance to the vortex, since often F can be larger in the vortex. 

The test in CFL3D is very simple-minded and can often fail. However, it is quite diffi- 
cult to find a test that works for all circumstances; so, for lack of anything better, the fol- 
lowing is used. Marching outward away from the body, F max is updated index by index. 
Then, if 

F<0 - 9F ma>r < H - 29 > 

the code stops searching. 


H.4 One- and Two-equation Field-equation Models 

All of the one- and two-equation model equations can be written in the general form 

4(X) + = S p + S D + D (H-3i 


where S p is a “production” source term(s), S D is a “destruction” source term(s), and D 

represents diffusion terms of the form • Note that S p and S D have been 

grouped together rather loosely. In Spalart’s model in CFL3D, for example, part of Spal- 
art’s production term is grouped in S D for convenience. In Menter’s model in CFL3D, the 

cross-derivative term is grouped in S D . In CFL3D, the S p terms are treated explicitly 
while the S D terms are linearized and treated implicitly. This is Spalart’s “third strat- 


All of the field-equation models are solved uncoupled from the Navier-Stokes equa- 
tions. All of the models are solved in essentially the same fashion. Details are given in 
“Solution Method” on page 299 in the form of an example. 
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Also, all of the one- and two-equation models are based on incompressible turbulence 
equations. No compressibility corrections have been added. Hence, for problems where 

the turbulent Mach number, M T = Jlk/a 2 , is high, these turbulence models may not be 

applicable. Note that for most subsonic through low supersonic aerodynamic applications, 
the incompressible forms of the turbulence models are generally expected to be valid. 

All of the field equation models except for Wilcox k - to make use of the minimum 
distance function, or the distance to the nearest wall, smin. This distance differs from the 
directed distance used by the Baldwin-Lomax model in that it does not follow grid lines 
and can be computed across zone boundaries. Hence, it is more easily applicable to multi- 
ple zone applications. The minimum distance function represents the distance to the near- 
est viscous wall and takes into account grid skewness when computing the nearest wall- 
point location (in subroutine f indmin_new). The exception is the Baldwin-Barth model 
which uses a minimum distance algorithm (subroutine findmin) that does not take grid 
skewness into account. (The reason for this exception is that the Baldwin-Barth model 
requires other variables not currently implemented in subroutine f indmin_new.) 


H.4.1 Baldwin-Barth Model 
(ivisc = 4) 

The Baldwin-Barth 9 model solves a single field equation for a turbulent Reynolds 
number term R : 


f + "^ = <c e/2 -c £| )7^ + 


v T ^a 2 /? i a 


c 2 Re a £ dXj\ T dxj 


where 



(C p -C F )- 


(H-32) 


Vj — C^RD^Dz 


(H-33) 




1 - exp 



(H-34) 



(H-35) 
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Since the Baldwin-Barth model requires y + (rather than just the minimum distance to 
the wall), additional information about the nearest wall point needs to be stored as well as 
the minimum distance function d. For simplicity, it is currently assumed that in the 

regions where y has an effect, these additional wall values are in the same grid zone as 
the point in question. 


H.4.2 Spalart-Ailmaras Model 
(ivisc = 5) 

The Spalart-Ailmaras 34 model solves a single field equation for a variable v related to 
the eddy viscosity through 
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P T = P */v 


where 


f = — ^ 

J v \ 3-3 

X +C Vi 


V 


The equation is 


9v dv 
3/ + 


fr = c ti [i-/ (J ]Q« 




/?e a ^2 


w M i a r, ,, , - , fA 3v 
+ «753^r + (1 + C ^ )v) ^ 


(Note that Spalart’s trip function is not used.) Also, 

ft 2 = C, 3 exp(-C, 4 x 2 ) 

d = distance to the closest wall = minimum distance function 


1+Cw 3 

f W - £ 6 -6 

* + C w. 


'C±<r* 

i +c : 6 


5 = r + C^r -r) 


£,( Re \ 2 ,2 


where 
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S = Q + 


f v = no longer used 


/ = i 2L_ 

l+X/v 


CFL3D currently uses Spalart’s Version la 34 . The fv3 term was employed as a smooth fix 
to prevent S from going negative prior to 12/97, but was removed after an error was dis- 
covered ( S and fv2 were also different). The constants are 


C. = 0.1355 


C W3 = 2.0 


2 

C “ 3 
C„ = 7.1 


c b 2 = 0622 K = 0.41 

C. =1.2 C = 0.5 

1 3 4 


„ < 1 + C V 

c w = —1 + — 

1 K 2 <* 


For the general form in Equation (H-30): 


X = v 


Sp = C ti [l-/, ; ]Q» 


Cw 2 = 0.3 


(note typo in ref. 34) 




0 = .--V-!2 + ^[( V + (1 + c^ 


Re a ^ 2 R e 


Note that in CFL3D, the S p and S D terms are grouped differently than Spalart’s. Part of 

Spalart’s production term is grouped into S D because it has the common factor M m /Re , 
like the other destruction terms. 


H.4.3 Wilcox k-Omega Model 


(ivisc = 6) 
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For Wilcox’s 46 model, 


0k 9k (Re') 1 5 IT., . 

t, +u ’37i = p p ^)- pk Hx?;J + P^ + ^kJlR7 




Re \ 10 




In this model, C. is incorporated into the definition of 0) , so 

H" 

pk 

p T = — 

1 co 


The production terms are approximated by 


P k = p T fi 


P w = YP^ 


The constants are 


Y = P K 

a k = 1/0.5 
G w = 1/0.5 


P' = = 0.09 

P = 0.075 
K = 0.41 


The minimum distance function d is not required by this model. However, at the present 
time it is still computed and stored by CFL3D. For the general form in Equation (H-30), 


X k = k 


s p,k - p Mr n [ Re 


^D, k “ P ^CD 


D = 
k P dxj 


^T\dkl( M 
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(H-70) 

(H-71) 

(H-72) 

(H-73) 
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P k = fI T fi (H-79) 

P w = ypQ 2 (H-80) 

The constants are calculated from <|) = F^, + (1 -F ! )<t> 2 » w h ere the <j)’s are the con- 


stants: 


- £i _ * 2 

Yl C P 

o, = 1/0.85 
K 1 

% = 1/0.5 

0! = 0.075 
K = 0.41 


_ K 2 

yi ’ 

a k = 1.0 

K 2 

a,., = 1/0.856 


P 2 = 0.0828 
a, = 0.31 


_ 500v(^~f 
‘ = 


P' = = 0.09 

F, = tanh(T 4 ) 

T = minfmaxCTj, r 3 ), r 2 ] 

r = 4pc 2 k 
d\CD k _J 


_ 7k fM, 

3 C.,(0rflFe 


9k 9(0 


CD k _„ = maxp — 5 - 5 -, 1x10 


(0 dxjdxj 


F 2 = tanhFI 
n = max(2r 3 , T t ) 


For the general form in Equation (H-30), 


X k = k 


_ 1 r^( M ~ 

Sp,k - plt T Q 


s D .k = -P'H^ 


„ 1 9 rr HT^kv^co 

k _ pSjCyLv + o k j9xJl/?e 
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X 0> = ® 


^P. CO - 


o i(Re\ . 1 3k dat( M oo 

P “feJ +2(I - F|)a “^S7lR7 




_ i 3 y 
P^Lv + 


H.4.5 Abid k-Epsilon Model 

(ivisc = 1 0) 

For the Abid 2 k-8 model, the equations are 


3k 3k 1 _ (M m \ f R e \ l 3 [( V T \dkY M « 

3 1 Uj dxj p k (^eJ e vM oc J + p3* y |v + a k j3xJ(,/?e 


3e 3e _ l D f^ „ z , (Re\ 1 3 [Y V T }del( M ~ 

3r Uj dxj p E [/?eJ e 2k 2 VM o J + p3j: y Lv + a e j3xj(/?e 




The production terms are approximated by 


The constants are 


p £ = cJm ^ 2 


C P = 1.45 
1 1 


C P = 1.83 

Co 


C ^ = 0.09 


The damping functions are given by 
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/ = [1+4 (Re x )]tanh (0.008 Re k ) 


, r. ( Re t. 

h = [1 - “P[-l2 


T (Lie 

Re, = 

k |l vm 


where d is the distance to the nearest wall. For the general form in Equation (H-30), 


X k = k 


„ 1 rk 2 ( M - 

S P,k - +T Q [ Re 


S - -ef — 

^D,k - £ l M _ 


_ i a ir jWkv"- 

k p3x 7 r + O k )dx j V Re 


X E = e 


Sp, ■ 




_ i d \( 

E P dxj r + <* e )dXj\ V Re 


H.4.6 EASM Gatski-Speziale k-Omega Model 


(ivisc = 8 and 1 2) 
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H.4.6 EASM Gatski-Speziale k-Omega Model 


EASM stands for Explicit Algebraic Stress Model. 3 Ivisc = 8 is the “linear” k - to ver- 
sion, treated as an eddy viscosity model, whereas ivisc = 12 is the fully nonlinear k - CO 
version. The two versions obtain jj,j with identical methods. However, the nonlinear 
model includes nonlinear terms added to the Navier-Stokes equations, whereas the linear 
model does not. (Its effect is felt only through the (i T term.) 

The k - to equations are of the same form as in the Wilcox k - to model (Equation (H- 
60) and Equation (H-61)). However, C ^ is not incorporated into the definition of to (it is 
now a variable coefficient), so, 

__ k 

- SP“ (H-106) 

The constants are different as well: 



(H-107) 


(H-108) 


T 

where x tj is given (dimensionally) in Equation (H-15). The variable C u and the coeffi- 

r 

cients K x and K 2 in Equation (H-15) are determined as follows: 


= 3(1 + r) 2 ) + 0.2(r| 6 + ^ 6 ) 

a 2 ^2 2 , Y 1 6 ^6 a l 

3 +r| +6^r| + 6C, + r| + £ 


(H-109) 



(H-110) 


(H-111) 
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where 


K\ = a 3 
K 2 = 2a 2 



a 2 = (2 -C 3 )| 
a 3 = (2-C 4 )| 



(H-112) 


(H-113) 


(Note that T|, and a are just used here to denote terms in the equations and do not 
reflect the definitions in the Nomenclature list.) Currently, the pressure-strain correlation 
is modeled with the Speziale-Sarkar-Gatski (SSG) correlation, which uses: 

C, = 6.8 C 3 = 1.25 C 5 = 1.88 

1 (H-114) 

C 2 = 0.36 C 4 = 0.4 C^* = 0.081 


To improve convergence, the (i x terms in xj multiplying the nonlinear terms 


S«W W -W„S tJ and S, t S kJ - S„8 # 


are replaced by 


, - . k 

t'T ■ c a P,T> 


CO 


(H-115) 


where 


C' = 


3(1+0") 


M 3 + ti 2 + 6^V + 6C 2 + 0 6 + C 6 1 

Also, the p T terms in the D k and D m diffusion terms are replaced by 


(H-116) 


= Vp- 


(H-117) 
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The minimum distance function d is not required by this model. However, at the present 
time it is still computed and stored by CFL3D. For the general form in Equation (H-30), 


X k = k 


(H-118) 


s = 

P ' k p Re 


(H-119) 


S D, k - ~P ,kt0 (^ 


(H-120) 


n i a if v - t * lakl^oc 

D v = -- — u + — — 

P dxj ^ CT k Jdxj {Re 


(H-121) 


x a> = ® 


(H-122) 


1 to jdujM 


n A W 1 { OO 

p ,(0 = 


(H-123) 


S D.» = 


(H-124) 


n 1 d IT M-X* pCoV^oo 

D co = -^r p + — 5- hr- 


PdXj\{ CT (o PxARe 


(H-125) 


H.4. 7 EASM Gatski-Speziale k-Epsilon Model 

(ivisc =11) 

The k — e version of the Gatski-Speziale EASM model 3 is only implemented as a non- 
linear model. Its equations are identical to those of the Abid k - e model (Equation (H-91) 
and Equation (H-92)), with 


^ pk 

Pt - 


(H-126) 


(There is no / term.) The constants are 
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C c = 1.83 


c c = c P - 


<W C ,* 


a k = 10 

a e = 1.3 
K = 0.41 


(H-127) 


The production terms are 


F T r)u : 

= C 'lk t, '57; 


(H-128) 


The variable C , and all constants are identical to those given for the EASM k - co model 
in “EASM Gatski-Speziale k-Omega Model” on page 286, except that co is replaced by 
e/k . The damping functions are given by 


f* = [‘ - exp (“ir) 


(H-129) 


where 


Re k = 


pjkdf Re 


(H-130) 


The (Xj terms in xjj multiplying the nonlinear terms are replaced in exactly the same way 
as for the EASM k - co model. Also, the \l t terms in the D k and D t diffusion terms are 
replaced by 

, 2 

* - r *£— (H-i3i) 

FT ~ '-|i e 


For the general form in Equation (H-30), 


X k = k 


_ 1 

S P.k - p x UB Xj \Re 


o ( Re 

S D,k - E ( M 
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n _ i a n lakl^oo 

k -paJ^ + a k Lfe 


X E = e 


_ 1 P T^ W /Y^oc 

S P. S - p C £ ,k T «3^(«7 


s °- = 






P^ll C E P X A Re 


H.4.8 EASM Girimaji k-Epsilon Model 

(ivisc = 9 and 1 3) 

The Girimaji 21 version of the EASM k-e model is implemented both as a “linear 7 
(eddy-viscosity) (ivisc = 9) and “nonlinear 77 (ivisc =13) version. The k — e equations are 


dk 3k _ 1 (M^\ (Re\ 1 d ( 

dt Jdxj p p3x Lv + CT k Jdjc JC/?^ 


S' J 3xj p 4 Re ) Cc ikU/J p3* 

+ cj^) 2 f-] 

2 k p \Re J 


k '“-V 


PiA 3 e ~\(M, 




= -C,/^ 


2 

The extra (8 Jk/dx j) term in the £ equation was added to replace the / 2 damping func- 
2 2 

tion term on the £ /k term, which is needed because £ /k oo at the wall. The con- 
stants are 
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c p = 1.44 = 1.0 


C F = 1.83 a £ = 1.3 
£ 2 


(H-143) 


The production terms are approximated by 


p » = 

E T^ u i 

P e - C e,k t ij a x 


(H-144) 


The damping functions is 


tanh r ( >.ois^r£. 

L H UC 


(H-145) 


xT is given (dimensionally) in Equation (H-15). However, K l and K 2 in that equation are 
now given by 


K x = 




L°L 


Til = 0 °1 = — 5 

(L|) +2t, 2 (L 4 ) 2 


L°L 


L = 0 G x = n2 ~ ~ 2 2 2 

(Lj) +|tl 1 (L 3 ) 2 + 2T l2 (L 4 ) 


D > 0 G, = -S + f-^ + TDj +(^---70 


1 < 0, b < 0 G, = - | + 2 a /~ 


a re 

— cos - 


3 v3 


_ p _ fa re , 27 t 

D<0,b>0 G| =-l + 2 J-3 COS U + T 
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(H-148) 

(H-149) 

(H-150) 

(H-151) 

(H-152) 

(H-153) 

(H-154) 

(H-155) 

(H-156) 
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(H-157) 

(H-158) 

(H-159) 

(H-160) 

(H-161) 

(H-162) 


H.5 Generalized Coordinate Form 

For the transformation from Cartesian coordinates to generalized coordinates, for 
example, 

3k _ 3k §k 3k 

'«I, 35 9? 

where 

U = *, X U + ky V + ?> Z W + 5, 

V = r\ x U + T) y V + X\ Z W + (H-164) 

W = l, x u + C, y v + C, Z W + £ f 

In the diffusion-type terms, cross-derivative terms are neglected. For example. 
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4^) - + ^(ViD + *4MD (H ' ,HI> 

+ ,i 4K 4 I) + n >U^) + ^(^l) 

+ + 

An example of the discretization is given for the first term on the right-hand side of Equa- 
tion (H- 165): 




2 2 


(H-166) 


where 


aU4' k, + 1 k/ m 


= k ,- k /-l 


(H-167) 


The locations of the indices are shown in Figure H-2. 



• i + 1 


1 ' t 

•-i -1 

Figure H-2. Definition of left and right states for generalized coordinate transformation. 


H.6 Initial Conditions 


For the Baldwin-Barth and Spalart-Allmaras models, the levels of the turbulence quan- 
tities R and v are initialized at their free-stream levels everywhere in the flow field. For 
the two-equation models, it helps the solution start-up phase to initialize the k and co (or 
k and e ) values to crude profiles that simulate typical profiles in a boundary layer. Cur- 
rently, for k - co : 
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k IC = max(k oo! - C^d +C 2 d) 
n = maxf- \2AAAd + 0.54, 


(H-168) 


where d is the distance to the nearest wall and, for EASM models, - 0.09 ; otherwise, 


C„ = 1.0 . Also, 


For k - e : 


v3d = 


t max = -C!S max + c 2 s n 


C, = 45.8 C 2 = 1.68 


k Tr = min{zk4, max[zkl, min(zk2, zk3)]} 


zkl = k„ 


zk2 = 10 


- 47 1 </ + 0.47 


zk3 = 10 
zk4 = 6.1d 


37. 5d - 3.7 


e IC = min{ep4, max[epl, min(ep2, ep3)]} 


epl = £oo 

. ,„-555d-6 

ep2 = 10 

. 1A - 280^-9.2 

ep3 = 10 

„ ■ /, i^ 20 ln 13333^-9.8 

ep4 = min(lxl0 , 10 ) 


280 ^- 9.2 


H. 7 Boundary Conditions 


H.7.1 Free-stream Levels 


For the Baldwin-Barth model, 
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R m = 0.1 

For the Spalart-Allmaras model, 

= 1.341946 

For the standard k - co or Menter’s SST models (C^ is incorporated into the definition 
of to). 


(H-174) 


(H-175) 


K = 9 x 10 
to^ = 1 x 10 


(H-176) 


For the EASM (k - co ) models, 


k„ = 9x 10~ 9 
= 9 x 10~ 8 


(H-177) 


For the k-e models, 

k„= lx 10“ 9 
e„ = 1 x 10" 17 

The end result for all models is 

Mr, oo = 0.009 


(H-178) 


(H-179) 


in the free stream. Note that co^ = 9 x 10 8 and £„ = 1 x 10 17 for the EASM models 
are based on = 0.09 , which is only approximate since is variable. 


H. 7.2 Boundary Conditions at Solid Walls 

With the parameters known at the cell-centers near the solid wall boundary (see the 
wall region schematic in Figure H-3), the following boundary conditions are applied. 

For Baldwin-Barth, 

R w = 0 (H-180) 

For Spalart-Allmaras, 
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• 2 



• 1 



Figure H-3. Parameter locations at wall boundary, 
v = 0 


For the k - co models, 


k w = ° 


60 |ii / M \ 2 

p.PW 2 ^ 


(H-181) 


(H-182) 


(H-183) 


P = 0.83 for the EASM k - 0) models and 
P = 0.075 otherwise. 


For the k- E models. 


k w = 0 


2ivaVkf r M ~f 


Ew pj V 5n JvXRe 


(H-184) 


(H-185) 


where n is the direction normal to the wall. 

Note that the actual wall boundary conditions for the turbulence quantities (unlike the 
primitive variables) are applied at ghost cells. Hence, 

Xbc = 2 X w -Xi (H - 186) 

where % represents R, v, k, to , or E . 
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Version 4.1 of CFL3D applied the above boundary condition for to (Equation (H- 
183)) at the ghost cell center rather than at the wall. This is not correct, but supposedly any 
wall boundary condition for to that is bigger by some factor than the “analytical” value 

6p.j/(p(3 y ) gives basically the same result. (See reference 26.) The current version of 
CFL3D (Version 5.0) obtains the ghost cell value using linear interpolation from oo w and 
CD, (or E w and e, ). 


H.8 Solution Method 

The one or two equations are solved, decoupled, using implicit approximate factoriza- 
tion (AF). The S p terms are treated explicitly, lagged in time while the S D and D terms 
are treated implicitly (they are linearized and a term is brought to the left-hand-side of the 
equations). This procedure is described by Spalart and Allmaras 35 (strategy #3). The 
advective terms are discretized using first-order upwinding. Treating the destruction terms 
implicitly helps increase the diagonal dominance of the left-hand-side matrix. Most of the 
S D terms are linearized in a simplified fashion by assuming no coupling between the vari- 
ables. For example, 

P'kco ( ” + 1 * = p , kto ( ” ) + Jj-( P'kco) Ak (H-ie7) 

= P'k(D ( " ) + P'coAk 

For the S D terms in the k - e equations, however, a more sophisticated approach was 

taken. When linearizing, the k and e variables are assumed to be coupled, with the eddy 
viscosity |i T assumed to be fixed. For example, in the k equation, S D = -E(Re/ M x ) is 
linearized as follows: 
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The S n = -C P —f?(Re/MJ term in the e equation is treated similarly, for consis- 
tency: 


k k devky 


(H-189) 


k 8e v Pt y 


= l‘VfWf A£ 

k 2V p T y 


e 2(,l) 3e 

5 k + 2k A£ 


Menter’s SST k - to model has an additional cross-diffusion term in the co equation. This 
term is treated implicitly (See reference 26). 


c (n + l) c (n) d_ c A 

c (o - c co + a(o c “ 

. c w_!£J A(0 

® (0 


(H-190) 


(The negative sign insures that, when taken to the left-hand side, this term increases the 
diagonal dominance of the implicit matrix.) 

H.8.1 Example 


This example shows the solution method for the k equation in Menter s SST model. 
All other equations are solved in a similar fashion. 


8k 8k ( M ~\ fj/j (Re\ 1 9 [(„ . M-T ^k Y^ 

di + “idxj ~ ^ VA* J + p8^|r aJdxJUe 


(H-191) 


Written in generalized coordinates, with the production term treated explicitly (lagged in 
time), this equation becomes: 
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ak<" +1) _ , 7 ^k ( " +1) _ v 5k (n + 1) _ w 3k (n + 1) 

dt 3 % 8ri w d$ 


1 a J p 2 e 2 s; 2 Y MrV k 

+ pa|| ( ^ + ^ + ^V + ^j5l 


a L 2 2 2 f HT^ak 


a f /r 2 r 2 r 2 .f Makllr M ~V" +1) 
+ 5d ( ^ + 5 » + ? «V + ^j55K«7j 


= RHSr 


2 2 2 

where the superscripts denote the time level. Note that the terms (2^ + % y + q z ) etc. are 

not strictly correct as written. This is really short-hand notation. The correct way to 
expand the diffusion terms is given in “Generalized Coordinate Form” on page 294. This 
section also indicates how these metric terms are discretized. 


u = ^x u + V + *>z w + 

V = + T\ y v + T) z w + ri ( 

w = + £> y v + ^ z w + C, 


(H-193) 


Define 


Ak = k ( ” + 1) -k ( ” ) 


(H-194) 


Then 


~ = RHS k 
At k 


(H-195) 


Linearize the right-hand-side terms that are taken at time level (n + 1 ) 


(H-196) 


ak^” +1 ) 3k^ -upwind,.,. 

~ u zi =~ u ?i ~ u h ( Ak ) 


(H-197) 
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(H-198) 


(H-199) 


where represents + ^ + t£)\\l + j—J- 

The equation is approximately factored and the contribution of the S D term to the left- 
hand side is added in the first factor only. 

[i + r " + *<£>•>» - 

[l + A,V8 n — 

+ = A,RHS k 

This equation is solved in a series of three sweeps in each of the three coordinate 
directions: 

i + A,U5,"-“ + A,(£)'co-A,(^)i^(X 6 6 5 )]Ak* = A,RHS„ 

[, + A, Va,— - A(^)^(X,8,)]Ak** = Ak* 

;i + A,^“—‘'-A,(^)I^(x ? 8 { )]Ak = Ak-* 
k ( " +1) = k^ + Ak 

Each sweep requires the solution of a scalar tridiagonal matrix. 


H.9 Limiting 

As a precaution, many of the turbulence quantities are limited in practice. Whether all 
of these conditions are necessary or not for the models to work and/or converge well is 
unknown. Some are probably included only because they were tried at some point and 
never removed. 
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•In all models, the linearized S D term is added to the left-hand-side matrix only if its 
contribution is positive. 

•In all models, the terms D, v, k, co, and e are not allowed to become negative. If the 
equation “wants” to yield a negative value, it is instead set to some very small posi- 
tive number. (A counter also sums the number of times this happen and it is output in 
the * . turres output file.) 

• In all the k - co models as well as the k - e models for Abid and Gatski-Speziale, 
the production term in the k equation (i.e. 

1 -rdujfMs 

p^ ij dXj\Re J 

or an approximation thereof) is limited to be less than or equal to 20 times the 
destruction term in that equation. 

•In all EASM models, the x u , r 22 , and t 33 terms are limited to be positive (realiz- 
ability constraint). 


•In all EASM models, the production term — is limited to be positive. 


»In the Girimaji EASM models, the production term 


1 idu t rM\ 
p ^^dXj\Re ) 


is limited (in both the k and e equations) to be less than or equal to 40e 



• In the Girimaji EASM models, the term 

is limited to be positive. 

•In all models, the nondimensional eddy viscosity p T is limited to be less than or 
equal to 100,000. 
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2 2 

•In the Gatski-Speziale EASM models, T) and £ are each limited to be less than or 
equal to 10. 

•In the Gatski-Speziale EASM models, C p is limited to be between 0.005 and 0.187. 


•In the k - e models, is limited to be less than or equal to 1. 

•In the Girimaji EASM models, T| j and t| 2 are each limited to be less than or equal to 

1200. 

•In the Girimaji EASM model, G, is limited to be between -0.005 and -0.2. 

•In the Gatski-Speziale EASM k - to models, “to” in the denominator of the nonlin- 
ear terms in is limited to be greater than or equal to the free-stream value of to . 

T . 

•In the EASM k - e models, “e”in the denominator of the nonlinear terms in x tj is 
limited to be greater than or equal to the free-stream value of e only in terms that 
appear in the Navier-Stokes equations. This limiting is not done for the terms that 
appear in the S p terms in the k and £ equations. 

•In the one- and two-equation models, the diffusion term in one coordinate direction, 
for example, can be written as 


In Baldwin-Barth and Spalart-Allmaras, the terms are limited 

B , = maxf-B 


B , = max| 
1 + 2 


U’°) 


lXi-i 

2 

as follows: 
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H. 10 Wall Function 

A simple approach for wall functions is taken from Abdol-Hamid, Lakshmanan, and 
Carlson 1 . This approach modifies the eddy-viscosity value p T w at the wall only. The wall 

shear stress is estimated from law-of-the-wall values at the first cell center off the wall and 
is used to determine an “equivalent” eddy viscosity at the wall. 

Wall functions can be employed when the grid spacing is too coarse in the direction 

normal to the wall; typically y + lies in the range 30 < y + < 200 . (The y + value of the first 
grid point off the wall should be 0(1) to ensure decent turbulent computations when no 
wall functions are used. See Section 2.2.) Wall functions are invoked in CFL3D by setting 
the value of ivisc(m) to be negative. 

A caution: While wall functions can work very well, they can also sometimes cause 
problems. They are not strictly valid for separated flows, although many people use them 
anyway with reasonable success. It is recommended that wall functions not be used with 
the Baldwin-Lomax model in CFL3D. With other turbulence models, it is recommended 
that they be used sparingly, if at all. In our opinion, it is better to make a turbulent grid 

(y + = 0(1)) whenever possible and avoid the use of wall functions. 

The wall function replaces the eddy viscosity at the ghost cell center at walls as fol- 
lows: 


Mr, ghost ^M’T, w Mt, i 


H T , W 


= Hi 


+2 

n Hi 


l2 Ue 


du^ _ J(u 1 ~ M w) 2 + ( V 1 ~ v w) 2 + (M , l 

dy)\ d x 


(H-202) 


where d x is the distance to the nearest wall from the first cell center off the wall and 
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a 0 (l) = 2.354039 
a 0 (2) = 0.117984 

a 0 (3) = -4.2899192xl0 -4 
a 0 (4) = 2.0404148x10 6 
a 0 (5) = -5.1775775x10 9 
a 0 (6) = 6.2687308x10 12 
a 0 (7) = -2.916958x10 15 


ai (l) = 5.777191 
a, (2) = 6.8756983 xlO -2 
a, (3) = -7.1582745x10 6 
a,(4) = 1.5594904x10 9 
a,(5) = -1.4865778x10 13 

a 2 (l) = 31.08654 
a 2 (2) = 5.0429072x10 2 
a 2 (3) = -2.0072314x10 8 
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Angle Definitions 



The definitions of a and p are the same as that given in reference 20 with the excep- 
tion that the direction of positive P is reversed. The figures below illustrate the difference. 


LI Standard-type Grid 

(Z is up and y is out the span) 

This is the default for CFL3D-format grids (also applies when ialph = 0 for PLOT3D- 
format grids). 


z 



CFL3D User's Manual 307 





APPENDIX I Angle Definitions 

Drag = component of forces parallel to V direction 

Lift = component of forces perpendicular to V cos|3 direction in the x — z plane 


1.2 Non- standard-type Grid 

(y is up and Z is out the span) 

(ialph > 0 for PLOT3D-format grids) 

y 



Drag = component of forces parallel to V direction 

Lift = component of forces perpendicular to V cos |3 direction in the x-y plane 
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Subroutine Listing 


CFL3D contains all the subroutines listed below: 


CBSEM 

RHS 

AF3F 

BC 

mgblk 

resid 

af 3f 

be 

setup 

resp 

amaf j 

bclOOO 

rp3d 

fa 

swaf j 

bclOOl 

setblk 

i2x 

amaf k 

bcl0 02 

global 

i2xs 

swafk 

bcl003 

lead 

f a2xj 

amaf i 

bclOOS 

qinter 

fa2xk 

swaf i 

bcl008 

qout 

fa2xi 

diag j 

bclOll 

qf ace 

gf luxr 

diagk 

bcl012 

plot 3c 

hf luxr 

diagi 

bclOl 3 

plot 3d 

f f luxr 

tinvr 

bc2002 

plot3 t 

xlim 

tdq 

bc2003 

update 

fhat 

dlutr 

bc2004 

updateg 

fill 

dfbtr 

bc2005 

resetg 

f luxp 

dlutrp 

bc2006 

xtbatb 

f luxm 

df btrp 

bc2007 

grdmove 

gf luxv 

dfhat 

bc2102 

resetwk 

hf luxv 

df luxpm 

chksym 

rpatch 

f f luxv 

gf luxl 

chkrap 

setqcO 

dird 

hfluxl 

chkrot 

setdqcO 

wmag 

f f luxl 

rield 

resadd 

delv 

abciz 

rielde 

readdat 

prntcp 

abc j z 

blockk 

getdhdr 

trans 

abckz 

block j 


transmc 

dabciz 

block! 


rotate 

dabc j z 

cblkk 


rotatmc 

dabckz 

cblkj 


hole 


cblki 


dthole 


int2 


blkmax 


int3 


rotateq 

rotateqO 

rotateqb 

bcchk 

xupdt 

getibk 

intrbc 

ccf 


LBCX 

LBCX fcontinued^ DYNPTCH 

tau 

f indmin_new 

dynptch 

tau2x 

bbdist 

globa!2 

colldat 

bbdstl 

patcher 

collx 

calc_dist 

loadgr 

collv 

col lect_sur f 

collapse 

collq 

distcc 

rechk 

coll2q 

disteg 

expand 

collqcO 

init f 

invert 

collxt 

ini ti 

shear 

collxtb 

i f ree 

arc 

addx 

f f ree 

diagnos 

addxv 

iialloc 

direct 

add2x 

i f alloc 

pro j ect 

add2xv 

makebb 

extra 

init 

ealebb 

extrae 

initvist 

getvrt 

topol 

rrest 

shells 

topol2 

rrestg 

spltbb 

dsmin 

wrest 

push 

xe 

wrestg 

pop 

xe2 

metric 

sort_x 

newf i t 

tmetric 

move_real 

trace 

cellvol 

move_i nt eger 

transp 

ctime 

triang 

rotatp 

vlutr 

heap_sort 


vlutrp 

entsur f 


bsub 

celcen 


bsubp 

yplusout 


q8sdot 

calyplus 


q8smax 

forceout 


q8smin 

histout 


q8ssum 



q8vrev 



12norm 



12norm2 



force 



esurf 



csout 



rsmooth 



xmukin 



f indmin 





TURBS 

blomax 

barth3d 

spalart 

twoeqn 

triv 
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J.l CBSEM Routines 

mgblk 

Advances the solution in time using multigrid acceleration. At each level in the multi- 
grid procedure, all the blocks are advanced before moving to the next level. 

setup 

Reads in the grid and restart data and calculates some preliminary information, such as 
the metrics, for subsequent use. 

rp3d 

Reads in the grids in PLOT3D format. 

setblk 

Initializes the blank array, 
global 

Reads in the case input file. 

lead 

Installs the attributes of a particular block into the common blocks. 

qinter 

Interpolates the solution from a coarser mesh to a finer mesh. The finer mesh can be 
either a global mesh or an embedded mesh. Also updates grid position of finer mesh if 
meshes are in motion. 

qout 

Outputs data for plotting or printing. 

qface 

Determines the primitive variables at the edges of the grid and installs them in the 
qjo/qko/qio arrays for use in output routines. 
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i in 


J.1 CBSEM Routines 


plot3c 

Writes the output file for the cell-centered points in PLOT3D format. (Outputs the grid 
and/or solution in single precision for use with FAST and/or PLOT3D.) Also prints solu- 
tion data to a printout file for a specified range of points. 


plot3d 

Writes the output file at the grid points in PLOT3D format. (Outputs the grid and/or 
solution in single precision for use with FAST and/or PLOT3D.) Also prints solution data 
to a printout file for a specified range of points. 


plot3t 

Writes turbulent information for the cell-centered points in PLOT3D format. 


update 

Updates the solution in time. 


updateg 

Updates the grid to a new position and obtains corresponding grid-boundary velocities 
for use in the boundary conditions. Also collocates new grid position to coarser levels and 
obtains grid-boundary velocities on coarser levels. Also updates moment center. 


resetg 

Checks to see if any blocks in the grid have been translated and/or rotated out of the 
bounds set in the input deck. If so, resets these blocks so that they are at or near the initial 
positions. If the rotational displacement of a block is reset, the solution must also be 
rotated to correspond to the reset position. (Resetting is allowed only for constant transla- 
tional speed, itrans = 1 , or constant rotational speed, irotat = 1 .) 

xtbatb 

Stores grid speeds and accelerations on the boundaries for use in setting no-slip and 
wall pressure boundary conditions for dynamic meshes. 

grdmove 

Moves the grid from one position to another. 
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resetwk 

Replaces all locations of the work array which were filled with integer values in sub- 
routine plot 3d with real values. (Otherwise, problems may arise later when a real array 
attempts to access the integer value located in memory.) 

rpatch 

Reads in the generalized-coordinate interpolation data for grid patching from a file. 

setqcO 

Stores conservative variables for use in second-order temporal differencing and sub- 
iteration. 

setdqcO 

Stores conservative variables (Q n - Q„ _ j ) for use in second-order temporal differenc- 
ing. 

resadd 

Adds additional terms to the right-hand side for sub-iteration and second-order tempo- 
ral accuracy. 

readdat 

Reads in auxiliary data arrays for the “2000 series” of boundary conditions. 


getdhdr 

Sets the character data for the main output file headers when the “2000” series of 
boundary conditions are used. 


J.2 RHS Routines 

resid 

Computes the residual contributions to the right-hand side. 

resp 

Computes and prints residuals and sums the forces. 
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J.2 RHS Routines 


fa 


Accumulates fluxes to insure conservation with grid embedding. 

i2x 

Interpolates the primitive variables from coarser meshes onto twice finer meshes for 
grid embedding. 

i2xs 

Interpolates the primitive variables from coarser meshes onto twice finer meshes for 
grid embedding. 

fa2xj 

Accumulates fluxes in the j direction for use on a twice coarser mesh to insure conser- 
vation with grid embedding. 

f a2xk 

Accumulates fluxes in the k direction for use on a twice coarser mesh to insure conser- 
vation with grid embedding. 

fa2xi 

Accumulates fluxes in the / direction for use on a twice coarser mesh to insure conser- 
vation with grid embedding. 

gf luxr 

Computes residual contributions for the right-hand side in the j direction from the 
inviscid terms. 

hf luxr 

Computes residual contributions for the right-hand side in the k direction from the 
inviscid terms. 

f f luxr 

Computes residual contributions for the right-hand side in the i direction from the 
inviscid terms. 
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xlim 

Performs monotone interpolations to the interfaces of the cells. 

fhat 

Computes Roe’s 31 generalized flux at the interface given the left and right states at the 
interface. 

fill 

Fills the edges of the q array for safety using a multi-plane vectorization technique. 

f luxp 

Computes the “positive” parts of the fluxes using the flux-vector-splitting method of 
van Leer . 39 

f luxm 

Computes the “negative” parts of the fluxes using the flux-vector-splitting method of 
van Leer . 39 

gf luxv 

Calculates the right-hand-side residual contributions in the j direction due to the vis- 
cous terms. 

hf luxv 

Calculates the right-hand-side residual contributions in the k direction due to the vis- 
cous terms when idf = 0. Calculates the implicit matrix terms when idf > 0. 

f f luxv 

Calculates the right-hand-side residual contributions in the i direction due to the vis- 
cous terms. 

dird 

Evaluates directed distance from the k = 0 wall and the i = 0/ j = 0 wall for use in 
evaluating the Baldwin-Lomax 10 turbulence model. 

wmag 

Evaluates the vorticity magnitude for use in determining the turbulent eddy viscosity. 
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J.3 AF3F Routines 

delv 

Evaluates the velocity derivatives at cell centers. 

prntcp 

Writes the pressures on the body (actually the cell centers closest to the body) to an 
output file for unsteady flow. 

trans 

Determines the increment to grid position due to a grid translation. 

transmc 

Determines the increment to moment center due to a grid translation. 

rotate 

Determines the increment to grid position due to a grid rotation. 

rotatmc 

Determines the increment to moment center due to a grid rotation. 

hole 

Zeroes out the right-hand-side residuals for the blanked points. 

dthole 

Updates the At values for the hole and fringe cells. The values will be replaced with 
A /_• . 

min 

blkmax 

Determines the location of the maximum residual. 


J.3 AF3F Routines 

af 3 f 

Advances the solution in time using a 3-factor spatially-split approximate factorization 
algorithm. 
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amaf j 

Formulates the implicit matrices in the j direction for the 3-factor algorithm. 

swaf j 

Solves the block 5x5 tridiagonal equations for the 3-factor spatially- split algorithm 
in the j direction. 

amaf k 

Formulates the implicit matrices in the k direction for the 3-factor algorithm. 

swaf k 

Solves the block 5x5 tridiagonal equations for the 3-factor spatially-split algorithm 
in the k direction. 

amaf i 

Formulates the implicit matrices in the i direction for the 3-factor algorithm. 

swaf i 

Solves the block 5x5 tridiagonal equations for the 3-factor spatially-split algorithm 
in the i direction. 

diag j 

Solves the scalar tridiagonal equations to approximate the spatially- split factor in the j 
direction of the 3-D spatially-split algorithm. 

diagk 

Solves the scalar tridiagonal equations to approximate the spatially-split factor in the 
k direction of the 3-D spatially-split algorithm. 

diagi 

Solves the scalar tridiagonal equations to approximate the spatially-split factor in the i 
direction of the 3-D spatially-split algorithm. 
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J.3 AF3F Routines 

tinvr 

Multiplies the inverse of the diagonalizing matrix T times the residual contribution 

tdq 

Multiplies the inverse of the diagonalizing matrix T times the change in characteristic 
combination of variables (T Aq). 

dlutr 

Performs the scalar tridiagonal (LU) decomposition. 

dfbtr 

Performs the back substitution for a scalar tridiagonal system of equation. 

dlutrp 

Performs the LU decomposition for a periodic scalar tridiagonal system of equations. 

dfbtrp 

Performs the back substitution for a periodic scalar tridiagonal system of equations. 

dfhat 

Computes a Jacobian matrix with respect to the primitive variables at the cell interface. 

The Jacobian evaluation is approximate, being taken as either A + or A“ (TAT 1 ), and is 
computed with metric terms from the interface and dependent variables fro the cell cen- 
ters. 

df luxpm 

Computes “positive” or “negative” parts of the flux Jacobians using the flux-vector- 
splitting method of van Leer . 39 

gf luxl 

Computes the left-hand flux contributions due to the inviscid terms for the j direction. 
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hfluxl 

Computes the left-hand flux contributions due to the inviscid terms for the k direc- 
tions. 

ffluxl 

Computes the left-hand flux contributions due to the inviscid terms for the i direction. 

abciz 

Zeroes out the left-hand-side matrix element with the help of the blank array. For a 
point with blank = 0, all elements of matrices a and c become zero. Only diagonal ele- 
ments matrix b is changed to 1 .0 for i implicit; j sweep. 

abc j z 

Zeroes out the left-hand-side matrix element with the help of the blank array. For a 
point with blank = 0, all elements of matrices a and c become zero. Only diagonal ele- 
ments matrix b is changed to 1 .0 for j implicit; k sweep. 

abckz 

Zeroes out the left-hand-side matrix element with the help of the blank array. For a 
point with blank = 0, all elements of matrices a and c become zero. Only diagonal ele- 
ments matrix b is changed to 1 .0 for k implicit; j sweep. 

dabciz 

Uses the blank values to modify the coefficient matrices, a, b, c, for the diagonal inver- 
sion in the i direction. 

dabc j z 

Uses the blank values to modify the coefficient matrices, a, b, c, for the diagonal inver- 
sion in the j direction. 

dabckz 

Uses the blank values to modify the coefficient matrices, a, b, c, for the diagonal inver- 
sion in the k direction. 
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J.4 BC Routines 


J.4 BC Routines 

be 


Determines boundary data/conditions at edges of grids. 

bclOOO 

Sets free-stream boundary conditions. 


bclOOl 

Sets symmetry plane boundary conditions. 

bcl002 

Sets extrapolation boundary conditions. 

bcl003 

Sets characteristic inflow/outflow boundary conditions. 

bcl005 

Sets inviscid surface boundary conditions. 


be 1008 

Sets tunnel inflow boundary conditions. 


bclOll 

Sets singular axis (half plane) boundary conditions. 


bcl012 

Sets singular axis (full plane) boundary conditions. 


bcl013 

Sets extrapolation boundary conditions for a singular axis. 


bc2002 

Sets pressure ratio; extrapolates other quantities. 
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bc2003 

Sets characteristic inlet boundary conditions at engine inlet given (estimated) inlet 
Mach number, total pressure ratio, total temperature ratio, and flow angle. 

bc2004 

Sets solid wall (viscous wall) boundary conditions. 

bc2005 

Sets periodic boundary conditions given angular rotation angle to the periodic face and 
its block number. 

bc2006 

Sets pressure via radial equilibrium condition; extrapolates other quantities. 

bc2007 

Sets all the primitive variables with standard CFL3D normalization; p/p m , u/a m , 
v/a 0 e , w/a„, />/(p„0- 

bc2102 

Sets the pressure ratio as a function of time; extrapolates the other flow-field quanti- 
ties. 

chksym 

Checks for symmetry boundary conditions in j , k , or i directions in order to apply 
boundary condition type 1011 (singular axis with half-plane symmetry). 

chkrap 

Checks for wrap-around in j , k , or i directions in order to apply boundary condition 
type 1012 (singular axis with full plane). 

chkrot 

Checks to make sure that the proper rotation angle for periodic boundary conditions 
has been set. 
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J.4 BC Routines 


rield 

Determines far- field boundary data using quasi- 1-D characteristic relations for bound- 
ary condition type 1003. 

rielde 

Determines far-field boundary data using quasi-l-D characteristic relations for bound- 
ary condition type 2003. 


blockk 

Transfers information from the block designated ir to the qko array of the block des- 
ignated it. 


blockj 

Transfers information from the block designated ir to the qjO array of the block des- 
ignated it. 


blocki 

Transfers information from the block designated ir to the qiO array of the block des- 
ignated it. 

cblkk 

Checks information transferred from the block designated ir to the qko array of the 
block designated it. 


cblkj 

Checks information transferred from the block designated ir to the qjO array of the 
block designated it. 


cblki 

Checks information transferred from the block designated ir to the qiO array of the 
block designated it. 


int2 

Linearly interpolates q from one grid to ghost cells of another grid using generalized 
coordinates without using a limiter on the gradients. 
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int3 

Linearly interpolates q from one grid to ghost cells of another grid using generalized 
coordinates using a limiter on the gradients. 

rotateq 

Rotates the solution contained in array q through a specified angle and stores the 
rotated solution in qrot. 

rotateqO 

Rotates the solution at ghost points contained in array qO (either qio, qjo, or qko 
through the angle A0 x /A0 > ,/A0 z and stores the rotated solution in qOrot. 

rotateqb 

Rotates the solution in the qb array through the angle A0^/A0 y /A0 z for the chimera 
scheme with rotating grids. 

bcchk 

Determines if the boundary conditions have been set and fills the end-points for safety. 

xupdt 

Updates the fringe points of overlapped grids with boundary values which have been 
interpolated from other grids to provide the mechanism for coupling the various grids. 

get ibk 

Reads the output from MaGGiE (but not the grids). 

intrbc 

Interpolates the corrections for boundary values for all grids overlapped in the current 
mesh. 

ccf 

Modifies u f , w f , a f (velocities and speed of sound at the far field) based on point vor- 
tex correction (used when i2d = -1 and the far-field boundary condition type is 1003). 
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J.5 LBCX Routines 

tau 

Computes a residual correction and stores the values of q for later use in determining 
corrections to finer grids in the multigrid iteration scheme. 

tau2x 

Puts the restricted residual from a finer embedded mesh into a coarser mesh. 

colldat 

Restricts auxiliary boundary condition data arrays to coarser meshes. 

collx 

Restrict x, y , and z values to coarser meshes. 

collv 

Restricts volumes to coarser meshes. 

collq 

Restricts q (the primitive variables) with a volume-weighted interpolation and residu- 
als to coarser meshes. Also restricts turbulent eddy viscosity in the case of turbulent flows 
to coarser meshes. 

coll2q 

Restricts q (the primitive variables) with a volume-weighted interpolation and residu- 
als from finer embedded meshes to coarser meshes. 

collqcO 

Restricts conservative variables Q n and Q„-Q n l to coarser meshes via summation 
over fine-grid cells for use in time-accurate multigrid. 

collxt 

Restricts xt (array containing grid speeds) to coarser meshes. 


CFL3D User’s Manual 323 


APPENDIX J Subroutine Listing 


collxtb 

Restricts xtb and atb (arrays containing grid boundary velocity and acceleration, 
respectively) to coarser meshes. 

addx 

Interpolates the solution or the correction from a coarser mesh to a finer mesh. 

addxv 

Interpolates the turbulence quantities from a coarser mesh to a finer mesh during mesh 
sequencing. 

add2x 

Interpolates the solution or the correction from a coarser mesh to a finer embedded 
mesh. 

add2xv 

Interpolates the turbulence quantities from a global mesh to an embedded mesh during 
mesh sequencing. 

init 

Sets the initial conditions on a mesh to be free stream. 

initvist 

Sets the turbulent initial conditions on a mesh. 

rrest 

Reads the restart file for a block. 

rrestg 

Reads the restart file to get the latest position for a dynamic mesh, along with corre- 
sponding metrics and grid-boundary speeds. Also reads qcO for a second-order accurate in 
time restart. 

wrest 

Writes the restart file for a block. 
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J.5 LBCX Routines 

wrestg 

Appends the latest position of a dynamic mesh to the end of the restart file. Also writes 
qcO for a second-order accurate in time restart. 

metric 

Calculates the cell-interface directed areas. 

tmetric 

Calculates the time-metric terms for a grid in motion. 

cellvol 

Calculates the cell volumes. 

ctime 

Calculates the time step for an input fixed Courant number or calculates the Courant 
number based on an input value of At . 

vlutr 

Performs the LU decomposition for a block 5x5 tridiagonal system of equations. 

vlutrp 

Performs the LU decomposition for a block 5x5 tridiagonal system of equations 
which is periodic. 

bsub 

Performs the back substitution for a block 5x5 tridiagonal matrix equation solution. 

bsubp 

Performs the back substitution for a block 5x5 tridiagonal matrix equation solution 
which is periodic. 

q8sdot (function) 

Computes the dot product between two vectors. 
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q8smax (function) 

Finds the maximum value in an array. 

q8smin (function) 

Finds the minimum value in an array. 

q8ssum (function) 

Sums the elements of a vector 

q8vrev 

Reverses the elements in an array. 

12norm 

Computes the L2-norm of the residuals or the change in primitive variables from one 
time to the next. 

12norm2 

Computes the L2-norm of the residuals, after subtracting out the contribution of the 
unsteady terms that were added in subroutine resadd. 

force 

Integrates the forces on the body. 

csurf 

Integrates control surface mass flow and momentum/forces. 

csout 

Writes control surface mass flow and momentum/forces to an output file. 

rsmooth 

Performs implicit residual smoothing (constant coefficient). 

xmukin 

Computes Sutherland’s formula with linear law at low temperatures. 
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f indmin 

Finds minimum distances from field points to viscous wall(s). 

f indmin_new 

Serves as a driver routine for computing distances to the closest viscous surface. 

bbdist 

Serves as a driver routine for determining the nearest bounding box for each field 
point. 

bbdstl 

Identifies the nearest bounding box for each field point. 

calc_dist 

Finds the minimum distance to field points using the recursive-box algorithm. 

collect_sur f 

Stores coordinates of surface points and identifies the neighbors of each surface point. 

distcc 

Averages the distance function based at grid points to one based at cell centers. 

distcg 

Collocates the fine-grid minimum distance function on a fine grid to a coarser grid. 

init f 

Initializes pointers to floating-point variables in recursive-box algorithm. 

init i 

Initializes pointers to integer variables in recursive-box algorithm. 

i free 

“Frees up” pointers to integer variables in recursive-box algorithm. 


CFL3D User’s Manual 327 


APPENDIX J Subroutine Listing 


f free 

“Frees up” pointers to floating-point variables in recursive-box algorithm. 

iialloc (function) 

Increments pointers to integer variables in recursive-box algorithm. 

ifalloc (function) 

Increments pointers to floating-point variables in recursive-box algorithm. 


makebb 

Serves as a driver routine for generating the bounding boxes for the recursive-box 
algorithm. 

cal ebb 

Calculates bounding boxes. 

getvrt 

Searches for all points that fall within a bounding box. 

shells 

Performs a shell sort. 

spltbb 

Subdivides bounding boxes. 

push 

Places an item into the stack and adjusts the pointer accordingly. 

pop 

Removes an item from the stack and adjusts the pointer accordingly. 

sort_x 

Sorts surface points with respect to x -coordinate. 
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J.5 LBCX Routines 


move_real 

Rearranges items in the real array x based on the pointer iperm. 
move_integer 

Rearranges items in the integer array x based on the pointer iperm. 
triang 

Finds the closest distance from a field point to the actual surface (i.e. not simply the 
closest discrete surface point), using local triangulation of the surface. 

heap_sort 

Sorts a list of points. 

cnt surf 

Counts the number of viscous surface points. 

celcen 

Finds cell centers of field points. 

yplusout 

Calls the routines necessary for calculating yplus at the first grid point above solid 
walls. 

calyplus 

Calculates y + in turbulent flows at solid surfaces in a block and calculates statistics for 
the y + distribution (average y + , maximum y + and its location, standard deviation). 

f orceout 

Writes the forces and moments on individual blocks, as well as a global force/moment 
summary, to an output file. 

histout 

Writes the convergence history for mean-flow equations and turbulence equations to 
an output file. 
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J.6 DYNPTCH Routines 

dynptch 

Establishes zone-to-zone communication for block interfaces that move relative to one 
another, using a patched-grid technique (nonconservative). 

global 2 

Reads the dynamic patch input parameters. 

patcher 

Calculates patched-grid interpolation coefficients. 

loadgr 

Loads the proper grid from a 1 -D storage array to a 2-D work array. 

collapse 

Checks for collapsed points in the grid and expands any collapsed lines detected. 

rechk 

Checks for branch cuts. 

expand 

Expands the grid at boundaries. 

invert 

Determines generalized coordinates of cell centers of the “to” grid in terms of the gen- 
eralized coordinate system(s) defined on the “from” grid(s). 

shear 

Determines the generalized coordinates of cell edge midpoints on ^ = 0 and T| = 0 
boundaries and determines the requisite shearing correction to the generalized coordinates 
near £, = 0 and/or q = 0 boundaries. 

arc 

Performs arc-length correction to the generalized coordinates near a boundary if 
required when shearing correction has failed. 
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diagnos 

Performs diagnostic checks on interpolation coefficients (generalized coordinates) 
found via search and inversion routines. 

direct 

Computes normalized directed area components, or equivalently, components of the 
unit normal to a cell face. 

proj ect 

Projects a point onto a plane. 

extra 

Computes extra mid-cell points in ^ direction. 

extrae 

Computes extra mid-cell points in T) direction. 

topol 

Searches appropriate “from” blocks for current “to” cell center. Driver routine for 
determining £, and T| of the cell center. 

topol 2 

Searches appropriate “from” blocks in one direction only for current “to” cell center 

dsmin 

Finds the closest point in a grid to a specified point. 


xe 

Selects proper coordinates to use for inversion. 

xe2 

Sets up the coefficients for locally fitting a polynomial variation in the ^ and T) direc- 
tions. 
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newf it 

Determines a new polynomial fit for cells with stubborn convergence. 


trace 

Writes the search routine history for the current “to” cell to unit 7. 

transp 

Translates the “from” block to provide complete coverage for interpolation for cases in 
which the complete physical domain is not modeled. 


rotatp 

Rotates “from” block to provide complete coverage for interpolation for cases in 
which the complete physical domain is not modeled. 


J. 7 TURBS Routines 

blomax 

Computes the turbulent viscosity distributions using the Baldwin-Lomax 10 two-layer 
eddy-viscosity model. 

barth3d 

Computes the turbulent viscosity distributions using the one-equation Baldwin-Barth 9 
turbulence model. 

spalart 

Computes the turbulent viscosity distributions using the one-equation Spalart 35 turbu- 
lence model. 

twoeqn 

Computes the turbulent viscosity distributions using the two-equation turbulence mod- 
els. 

triv 

Solves a scalar tridiagonal system of equation 
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K.l Significant Differences Between Versions 5.0 and 4.1 

1. The most significant difference between the two versions is the generalization of mov- 
ing grid capability and the added capability to handle sliding patched interfaces. 

2. The viscous wall boundary condition now sets wall temperature locally rather than 
globally. 

3. The capability to output control surface information and turbulence quantity informa- 
tion has been added. 

4. There are slight differences in how the k - (0 wall boundary conditions are set internal 
to the code (the new way is more “correct”). This change may result in very small dif- 
ferences in convergence, but the end result should be nearly identical to the old way. 

5. The Baldwin-Lomax model can be applied on jdim/kdim/idim bodies now. 

6. In 2-d, the “far-field point-vortex correction” boundary condition can now be applied. 
Set i2d = -1, in combination with 1003. 

7. A few more boundary conditions have been added. 

8. Several more turbulence models have been added. Also, the “SSTZ” version of the 
SST k - co model has been removed. 

9. A crude wall function capability has been added. 

10. Some very minor differences, which may result in nearly insignificant differences 
between Version 4.1 and Version 5.0 results, are: 

(a) For the Wilcox k - co model, Version 5.0 limits the production term in the k equa- 
tion to be less than 20 times the destruction term. Version 4.1 does not. 

(b) In Version 4. 1 , the input alpha and beta angles (in degrees) are transformed to radi- 
ans by dividing by 57.2958. In Version 5.0, the transformation (using parameter 
radtodeg) is more precise. 

1 1. Both the input file and the restart file are different. See the following section for details 
on the differences in the input file. Any existing Version 4.1 input file or restart file can 
be automatically transformed to a Version 5.0 file by using v4tov5_input . f or 
v4tov5_restart . f, located in the Tools directory. (See “The Code and Supplemen- 
tary Files” on page 9.) 
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K.2 Summary of Changes to the Input File 

Version 5.0 of CFL3D originated when the generalization of moving grid capability 
(including sliding patched interfaces) was added to Version 4.1. As a consequence, the 
method for controlling the movement of any dynamic grids, patched or not, is now con- 
trolled from a new “section” at the end of the input file. Other than this, most changes to 
the input file, for either improved clarity or added capability, are relatively minor. After 
obtaining Version 5.0 of CFL3D, veteran users may notice some minor differences from 
Version 4.1. For those changes involving new input parameters, be sure to read about them 
in Chapter 3. Any existing Version 4.1 input file can be automatically transformed to a 
Version 5.0 input file by using v4tov5_input . f , located in the Tools directory. (See “The 
Code and Supplementary Files” on page 9.) 

In the following, note that sample numerical values, which of course are case depen- 
dent, are included. 


1 . 

Line Type Three changed from 






XMACH 

ALPHA 

BETA 

REUE , MIL 

T INF, DR 

ISND 

C2SPE 


0.8750 

00.000 

0.0 

02 . 660 

460.0 

0 

0.0 


to 








XMACH 

ALPHA 

BETA 

REUE, MIL 

TINF , DR 

IALPH 

IHIST 


0.8750 

00.000 

0.0 

02 .660 

460.0 

0 

0 


(Note: isnd and c2spe now 

handled by Twtype 

in the boundary condition section. 

2. 

Line Type Five changed from 






DT 

IREST 

IFLAGTS 

FMAX 

IUNST 

RFREQ 

ALPHAU 

CLOC 








-02.000 

0 

000 

05.0000 

0 

0.39600 

0.22200 

0 . 

50000 








to 








DT 

IREST 

IFLAGTS 

FMAX 

IUNST 

CFLTAU 



-02 . 000 

0 

000 

05.0000 

0 

10. 



(Note: Unsteady grid motion is now handled in Line Types Thirty-Three through 
Fourth-Five) 

3. Any boundary condition (Line Types Fourteen through Nineteen) with viscous wall 
(bctype 1004) changed from 

1 1 1004 0 0 0 0 0 

to 

1 1 2004 0 0 0 0 2 

TWTYPE CQ 

0 . 0 . 

4. The 1-1 blocking section of the input file has been modified so that the parameter 
names are more pertinent and so that the bookkeeping of 1-1 interfaces is simplified. 
Line Types Twenty-Four through Twenty-Seven have been changed from 

1-1 BLOCKING DATA: 

NBLI 

2 

NBLON NBLK ( 1 ) NBLK ( 2 ) 

Oil 
0 3 4 

LIMBLK(l) LIMBLK ( 2 ) LIMBLK { 3 ) LIMBLK ( 4 ) LIMBLK ( 5 ) LIMBLK ( 6 ) ISVA{1,1) 

ISVA (1,2) 

1112 41 112 
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1 

1 

1 

2 

63 

1 

1 

LIMBLK ( 1 ) 
ISVA (2,2) 

LIMBLK (2) 

LIMBLK (3) 

LIMBLK (4) 

LIMBLK (5) 

LIMBLK (6) 

ISVA (2,1 


1 

257 

1 

2 

217 

1 

1 

to 

1 

1 

51 

2 

63 

51 

2 


2 

2 

3 


1-1 BLOCKING DATA: 

NBLI 

2 

NUMBER GRID : ISTA JSTA 

11 11 

2 3 11 

NUMBER GRID : ISTA JSTA 

11 1 257 

2 4 11 


KSTA 

I END 

JEND 

KEND 

ISVAl 

ISVA2 

1 

2 

41 

1 

1 

2 

1 

2 

63 

1 

1 

2 

KSTA 

I END 

JEND 

KEND 

ISVAl 

ISVA2 

1 

2 

217 

1 

1 

2 

51 

2 

63 

51 

2 

3 


The parameter nblon is no longer used (it is always 0). The values for nblk(l) and 
nblk(2) are now assigned under grid in Line Types Twenty-Five and Twenty-Six, 
respectively. The parameter number is intended to help the user keep track of inter- 
face numbers. This is particularly useful when there are a very large number of 1-1 
interfaces. This parameter is not used internal to the code. 


5. After nprint section, the following Line Types (Thirty-One and Thirty-Two) must be 
added: 

CONTROL SURFACE: 

NCS 

0 

GRID I START I END JSTART JEND KSTART KEND IWALL INORM 

These lines (in combination with ihstry) control output of control surface information, 
such as mass flow. (Note: When using a control surface for print out, then ncs 0 and 
there will be at least one additional line under grid...) 

6. The above items 1-5 are all that are necessary to transform an existing Version 4.1 
input file (with non-moving grid) to a Version 5.0 input file. For a moving grid, Ver- 
sion 5.0 now has the additional section Line Types Thirty-Three through Forty-Five, 
required if and only if iunst > 0. 
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to the F-18 Forebody with Actuated Control Strake,” Computing Systems in Engineer- 
ing, Vol. 1, Nos. 2-4, pp. 563-576, 1990. 

2. Compton, W., Thomas, J., Abeyounis, W., and Mason, M., “Transonic Navier-Stokes 
Solutions of Three-Dimensional Afterbody Flows,” NASA TM 4111, July 1989. 

3. Ghaffari, F., Luckring, J., Thomas, J., Bates, B., and Biedron, R., “Multiblock Navier- 
Stokes Solutions About the F/A-18 Wing-LEX-Fuselage Configuration,” Journal of 
Aircraft, Vol. 30, No. 3, pp. 293-303, 1993. 

4. Rumsey, C., Biedron, R., and Thomas, J., “CFL3D: Its History and Some Recent 
Applications,” NASA TM-1 12861, May 1997; presented at the “Godunov’s Method 
for Gas Dynamics” Symposium, Ann Arbor, MI, May 1-2, 1997. 
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1990. 
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Navier-Stokes and Panel Method Solutions and Comparison with Experiment,” Amer- 


CFL3D User's Manual 337 







CFL3D Papers 


ican Helicopter Society Aeromech Specialists Conference, pp. 3.5-1 - 3.5-20, January 
1994. 

10. Garriz, J., Vatsa, V., and Sanetrik, M., “Issues Involved in Coupling Navier-Stokes 
Mean-Flow and Linear Stability Codes,” AIAA 94-0304, 1994. 

11. Ghaffari, F., Bates, B., Luckring, J., and Thomas, J., “Transonic Navier-Stokes Solu- 
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12. Hsieh, T. and Wardlaw, A., “Unsteady Aerodynamics of a Transient Pitching Missile 
Body from 0 Degrees to 25 Degrees,” AIAA 94-3500, 1994. 

13. Jones, K., Biedron, R., and Whitlock, M., “Application of a Navier-Stokes Solver to 
the Analysis of Multielement Airfoils and Wings Using Multizonal Grid Techniques,” 
AIAA 95-1855, 1995. 

14. Krist, S. L., A Grid-Overlapping Technique Applied to a Delta Wing in a Wind Tunnel, 
Masters thesis, George Washington University, 1994. 

15. Krist, S., Washburn, A., and Visser, K., “A Computational and Experimental Investi- 
gation of a Delta Wing with Vertical Tails,” AIAA 93-3009, 1993. 

16. Lessard, V., “Analysis of a High Speed Civil Transport Configuration at Subsonic 
Flow Conditions Using a Navier-Stokes Solver,” NASA CR 4490, 1993. 
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Wing,” NASA CR 4635, 1994. 

18. Londenberg, W., “Turbulence Model Evaluation for the Prediction of Flows Over a 
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pp. 203-209, 1992. 
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Lee-Side Flows Over Supersonic Delta Wings - A Correlation With Experiment,” 
NASA TP-3035, 1990. 

21. Melnik, R., Siclari, M., Marconi, F., Barber, T., and Verhoff, A., “An Overview of a 
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22. Milholen, W., Chokani, N., and Al-Saadi, J., “Performance of Three-Dimensional 
Compressible Navier-Stokes Codes at Low Mach Numbers,” AIAA Journal, Vol. 34, 
No. 7,pp. 1356-1362, 1996. 
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23. Newsome, R., “Navier-Stokes Simulation of Wing-Tip and Wing-Juncture Interac- 
tions for a Pitching Wing,” AIAA 94-2259, 1994. 

24. Rivers, M. and Wahls, R., “Comparison of Computational and Experimental Results 
for a Supercritical Airfoil,” NASA TM-4601, 1994. 

25. Robinson, B. and Yeh, D., “Toward Certification for CFD Codes for Aft End/Nozzle 
Configurations,” AIAA 94-2242, 1 994. 

26. Rudy, D., “Validation Studies for CFL3D, CFL3DE, and GASP Codes,” Paper No. 

1 15, 10th National Aero-Space Plane Technology Symposium, April 1991. 

27. Rumsey, C., “Computation of Acoustic Waves Through Sliding-Zone Interfaces,” 
AIAA Journal, Vol. 35, No. 2, pp. 263-268, 1997; also, “Computation of Acoustic 
Waves Through Sliding-Zone Interfaces Using an Euler/Navier-Stokes Code,” AIAA 
96-1752, 1996. 

28. Stephens, M., Shih, T., and Civinskas, K., “Computation of Flow and Heat Transfer in 
a Rectangular Channel with Ribs,” AIAA 95-0180, 1995. 

29. Tai, T., “Simulation and Analysis of V-22 Tiltrotor Aircraft Forward Flight Flowfield,” 
AIAA 95-0045, 1995. 

30. Thomas, J., “An Implicit Multigrid Scheme for Hypersonic Strong-Interaction Flow- 
fields ” Communications in Applied Numerical Methods, Vol. 8, pp. 683-693, 1992. 

31. Yagle, Patrick, An Investigation of the Effect of Turbulence Model and Boundary 
Layer Transition on Predicting Vortical Flows on 65 degree Delta Wings at Mach 1.6, 
Masters Thesis, George Washington University, September 1995. 


Turbulence Model References 

k-e: 

32. Abid, R., “Evaluation of Two-Equation Turbulence Models for Predicting Transitional 
Flows”, International Journal of Engineering Science, Vol. 31, pp. 831-840, 1993. 

Baldwin- Barth: 

33. Baldwin, B. and Barth, T., “A One-Equation Turbulent Transport Model for High 
Reynolds Number Wall-Bounded Flows,” NASA TM-102847, August 1990. 
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Baldwin-Lomax: 

34. Baldwin, B. and Lomax, H., “Thin Layer Approximation and Algebraic Model for 
Separated Turbulent Flow,” AIAA 78-257, 1978. 

35. Degani, D. and Schiff, L., “Computation of Supersonic Viscous Flows Around 
Pointed Bodies at Large Incidence,” AIAA 83-0034, 1983. 


k - (0 (SST): 

36. Menter, F„ “Improved Two-Equation k - go Turbulence Models for Aerodynamic 
Flows,” NASA TM 103975, 1992. 


37. Menter, F., “Zonal Two Equation k - (0 Turbulence Models for Aerodynamic Flows,” 
AIAA 93-2906, 1993. 


38. Menter, F. and Rumsey, C., “Assessment of Two-Equation Turbulence Models for 
Transonic Flows ,” AIAA 94-2343, 1994. Some corrections to this paper are: 


Equation (1) should be: 


cp r = p + ap, 
a*p, = p + a*p, 


Equation (17) should be: T = max(2r 3 , Tj) 


Spalart-Allmaras 

39. Spalart, P. and Allmaras, S„ “A One-Equation Turbulence Model for Aerodynamic 
Flows,” La Recherche Aerospatiale , No. 1, pp. 5-21, 1994. 

40. Spalart, P. and Allmaras, S., “A One-Equation Turbulence Model for Aerodynamic 
Flows” AIAA 92-0439, 1992. 


Wilcox k- to : 

41. Wilcox, D., “Reassessment of the Scale Determining Equation for Advanced Turbu- 
lence Models”, AIAA Journal, Vol. 26, No. 1 1, pp. 1299-1310, 1988. 

EASM k-t o and k-E (as eddy-viscosity or as non-equilibrium): 

42. Gatski, T. and Speziale, C., “On Explicit Algebraic Stress Models for Complex Turbu- 
lent Flows,” Journal of Fluid Mechanics, Vol. 254, pp. 59-78, 1993. 
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43. Abid, R., Rumsey, C., and Gatski, T., “Prediction of Nonequilibrium Turbulent Flows 
with Explicit Algebraic Stress Models,” AIAA Journal, Vol. 33, No. 1 1, pp. 2026- 
203 1 , November 1995. 

44. Gatski, T., “Prediction of Airfoil Characteristics with Higher Order Turbulence Mod- 
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45. Girimaji, S., “Fully-Explicit and Self-Consistent Algebraic Reynolds Stress Model ” 
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retical and Computational Fluid Dynamics, Vol. 8, pp. 387-402, 1996. 
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grid file 12,65 

grid overlapping 11,13 

grid patching 11,13 

grid point 79 

grid spacing 12,65,305 

grid stretching 65 

grid zone 3 

GRIDGEN xi 

grid-overlapping file 70 

grid-patching file 70 

H 

hole 116 
hole point 116 

I 

i2d 24, 80 
iad vance 25 
ialph 19 
icO 50 
ichk 24 
iconsf 35, 120 
idiag 30 
idim 28 
ie 30 
iem 25 

iend 33,34,38,40,41,42 

ifds 31 

ifit 49 

iflagts 22 

iflim 30 

iforce 25 

igridc 29 

ihstry 20 

line 40, 41 

ilamhi 28 

ilamlo 28 

inewg 29 

inflow boundary condition 84, 92 

initial conditions 82, 295 

inorm 42 

input file 12,17 

input parameter 17 

int 49,51 

intdir 97 

inviscid fluxes 239 

inviscid surface boundary condition 86 

iorph 50 
iovrlp 31 
iptype 39, 41 
irest 22 
irotat 47 
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is 30 

isnd 94 
issc 36 
issr 36 

ista 33, 34, 37 
istart 40, 41, 42 
isval 38 
isva2 38 
ita 24 
itmax 49 
itoss 50 
itrans 44 
iunst 22 
ivisc 26 
iwall 42 

J 

jdim 28 
je 30 

jend 32,34,38,40,41,42 

jinc 40,41 

jlamhi 28 

jlamlo 28 

js 30 

jsta 32, 34, 37 
jstart 40, 4 1 , 42 

K 

kdim 28 

ke 30 

kend 32,33,38,40,41,42 
k-epsilon model 26, 27 
kinc 40, 4 1 
klamhi 28 
klamlo 28 

k-omega model 26, 27 
ks 30 

ksta 32, 33, 37 
kstart 40, 4 1 , 42 

L 

Ibex . f 9, 309 

limit 49 

limiting 302 
Iref 43, 46, 101 
LRR xi 

M 

Mach 92 

MaGGiE xi, 116 
makefile 9 
me eta 50 
mexie 50 

Menter’s k-omega SST model 26, 283 
metrics 90, 257, 263 

mgflag 35 
mglevg 37 

minimum distance function 274, 278, 279, 280, 282, 289 

min-mod limiter 241 

mitL 37 

moments 269 

movie 40 

mseq 35 

mtt 35 
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multielement airfoil 168 
multigrid 123, 125 
multigrid algorithm 251 
multigridable 129 
multi stream nozzle 184 
multitasking 1 1 

N 

NACA xi 

NACA 001 2 airfoil 157,162 
Navier-Stokes equations 229, 239, 255 

nbciO 31 
nbcidim 31 
nbcjO 31 
nbcjdim 31 
nbckO 31 
nbckdim 31 
nbli 37 
ncg 25 
ncs 42 
ncyc 36 
ndata 32, 34 
negative volume 225 
nemgl 37 
nfb 51 
ngam 35 
ngrid 23 
ngridc 97 
ngridp 95 
ninter 38 
ninter2 49 
nitfol 37 

nondimensionalization 53, 185,274 
no-slip condition 93 

nplot3d 23 
nprint 23 
nrotat 46 
ntrans 43 
ntstep 24 
number 37 
n wrest 23 

O 

omegax 47 
omegay 47 
omegaz 47 

onc-equation field-equation model 277 
Onera M-6 wing 215 
one-to-one blocking 4, 102 
outflow 84 

outflow boundary condition 84 
output file 71 

overlapped grid 1 1, 13, 1 16, 130, 157, 168 
overlapping 4 
overset grid 4 

P 

p/(rho_inf*a__inf**2) 100 
P/Pinf 97 
p/pinf 92, 101 

patched grid 11, 13, 111, 162 
patching 4, 11, 13 
periodic boundary condition 95 
physical time 233 
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PL0T3D xi 
PL0T3D file 39,71 
PL0T3D function file 39, 72, 76 
PLOT3D-type grid 66 
point-vortex correction 24, 85, 333 
primitive variables 253 

primitive variables (specified) boundary condition 100 
pseudo time 233 

Pt/Pinf 92 

R 

radial pressure equilibrium boundary condition 97 
RAE xi 

RAE 2822 airfoil 152 
reference state 3 
residual smoothing 36, 227, 252 
restart file 68 

reue 19 

Reynolds number 19, 55 
rfreq 44, 47 
rfreqp 101 
rho/rho_inf 100 
rhs . f 9, 309 
right-hand rule 67 
rkapO 31 
ronnie 1 1 5 
rotor stator 194 

S 

segment 32, 33, 34, 35 
semi-coarsening 121 

singular axis boundary condition 88, 89, 90 

singular metrics 90 

smin 95, 278 

smooth limiter 24 1 

Spalart-Allmaras model 26, 279 

spatial discretization 239 

specified pressure ratio boundary condition 92, 100 

sref 20 

SSG xi 

SST xi 

steady state 4 

sub-iterations 139,233 

symmetry plane boundary condition 83 

T 

target cell 1 1 6 
test cases (2-d) 10,151 
test cases (3-d) 10, 206 
time accurate 4,139 
time advancement 233 
tinf 19 
TLNS3D xi 
to 51 

troubleshooting 225 

Tt/Tinf 92 

turbs . f 9, 309 

turbulence model 1 77, 27 1 

turbulence model equations 27 1 

two-equation field-equation model 277 

Twtype 93 

U 

u/a_inf 100 
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utrans 44 

V 

v/a_inf 100 
variable data 1 0 1 
V-cycIe 125 
vibrating flat plates 177 
viscous fluxes 249 

viscous surface boundary condition 93 

vtrans 44 

W 

w/a_inf 100 
wall function 305 
W-cycle 125 

Wilcox k-omega model 26,281 

wtrans 44 

X 

xiel 51,52 
xie2 51,52 
xmach 19 
xmc 21 
xorig 47 

Y 

y + 176,276,279,305 
ymc 21 
yorig 47 

Z 

zero-equation model 274 
zmc 21 
zorig 47 
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